일괄 가져오기 CSV 형식 지정

import 메서드를 사용하여 제품 세트와 참조 이미지가 있는 제품을 만드는 동시에 CSV 파일을 사용할 수 있습니다. 이 페이지에서는 CSV 파일의 형식을 지정하는 방법을 설명합니다.

참조 이미지 만들기

참조 이미지는 상품의 다양한 보기를 포함하는 이미지입니다. 다음과 같은 권장사항이 적용됩니다.

파일 크기가 최대 크기(20MB)를 초과하지 않는지 확인하세요.
어떻게 하면 제품을 논리적으로 돋보이게 하고 적절한 시각적 정보를 포함할 수 있을지 고민해 보세요.
누락된 시각을 보충하는 참조 이미지를 만드세요. 예를 들어 오른쪽 신발의 이미지만 있다면 이 파일의 반전된 버전을 왼쪽 신발로 제공하세요.
사용 가능한 최고 해상도의 이미지를 업로드하세요.
제품을 흰색 배경으로 보여주세요.
투명한 배경의 PNG를 불투명한 배경으로 변환하세요.

이미지는 Cloud Storage 버킷에 저장되어야 합니다. 이미지 생성 호출을 API 키로 인증하는 경우에는 버킷이 공개 상태여야 합니다. 서비스 계정으로 인증하는 경우에는 서비스 계정에 버킷에 대한 읽기 액세스 권한이 있어야 합니다.

CSV 형식 지정 가이드라인

import 메서드를 사용하려면 CSV 파일 그리고 이 파일이 가리키는 이미지가 모두 하나의 Cloud Storage 버킷에 있어야 합니다. CSV 파일은 최대 20,000줄로 제한되며 각 줄은 최대 2,048자(영문 기준)로 제한됩니다. 더 많은 이미지를 가져오려면 여러 CSV 파일로 나눕니다.

CSV 파일은 한 줄에 이미지 하나를 포함해야 하며 다음 열을 포함해야 합니다.

image-uri: 참조 이미지의 Cloud Storage URI입니다.
image-id: 선택사항. 사용자가 제공하는 고유한 값. 사용자가 값을 제공하지 않으면 자동으로 고유한 값이 할당됩니다.
product-set-id: 이미지를 가져올 제품 세트의 고유 식별자
product-id: 참조 이미지로 식별되는 제품의 사용자 정의 ID. product-id 하나에 여러 참조 이미지를 연결할 수 있습니다.

참고: 하나의 제품이 여러 제품 세트에 속할 수도 있습니다. product-id가 이미 일괄 가져오기에 존재하면 해당 줄 항목에 대해 product-category, product-display, labels가 무시됩니다.
product-category: 허용되는 값은 homegoods-v2, apparel-v2, toys-v2, packagedgoods-v1, general-v1*이며, 참조 이미지로 식별되는 제품의 카테고리를 나타냅니다. 만들기 요청에 지정되지 않으면 시스템에서 추론됩니다. productCategory 참조 문서에도 허용되는 값이 나와 있습니다.

* 기존 productCategory 코드: 기존 카테고리(homegoods, apparel, toys)도 계속 지원되지만 새 제품에는 업데이트된 -v2 카테고리를 사용해야 합니다.
product-display-name: 선택사항. 제품 displayName에 이름을 입력하지 않으면 ' '로 설정됩니다. 이 값은 나중에 업데이트할 수 있습니다.
labels: 선택사항. 참조 이미지의 상품을 설명하는 (따옴표로 묶인) 키-값 쌍의 문자열입니다. 예를 들면 다음과 같습니다.
- "category=shoes"
- "color=black,style=formal"
  
  Vision API 제품 검색에서는 하나의 키에 여러 값을 제공할 수 있습니다. 예를 들면 다음과 같습니다.
- "category=shoes,category=heels"
- "color=black,style=formal,style=mens"
bounding-poly: 선택사항. 참조 이미지에서 관심 영역을 지정합니다. 경계 상자가 지정되지 않은 경우 다음과 같이 처리됩니다.
1. 이미지의 경계 상자는 Vision API에 의해 추론됩니다. API가 여러 이미지를 감지하면 단일 이미지의 여러 영역에 대하여 색인이 생성될 수 있습니다.
2. 라인은 쉼표로 끝나야 합니다.
아래에서 경계 폴리가 지정되지 않은 제품의 예시를 참조하세요.

경계 상자를 포함할 경우 boundingPoly 열에 짝수 개수의 숫자를 쉼표로 구분하여 p1_x,p1_y,p2_x,p2_y,...,pn_x,pn_y와 같은 형식으로 포함해야 합니다. 예를 들면 0.1,0.1,0.9,0.1,0.9,0.9,0.1,0.9와 같습니다.

이미지의 실제 픽셀 값으로 경계 상자를 정의하려면 음수가 아닌 정수를 사용하세요. 따라서 다음과 같이 경계 상자를 1,000픽셀x1,000픽셀 이미지로 표현할 수 있습니다.
```
gs://example-reference-images/10001-001/10001-001_A.jpg,img001,sample-set-summer,sample-product-123,tan summer bag,apparel-v2,"style=womens,color=tan",100,150,450,150,450,550,100,550
gs://example-reference-images/10001-001/10001-001_A.jpg,img001,sample-set-summer,sample-product-456,blue summer bag,apparel-v2,"style=womens,color=blue",670,790,980,790,980,920,670,920
gs://example-reference-images/10002-002/10002-002_B.jpg,img002,sample-set-summer,sample-product-123,apparel-v2,,,
```
참고: Vision API의 객체 로컬라이저 기능을 사용하여 이미지에 있는 일반화된 객체의 경계 상자 좌표를 가져올 수 있습니다.

또한 Vision API 제품 검색에서는 경계 상자에 정규화된 값을 사용할 수 있습니다. [0, 1]의 float 값으로 정규화된 값을 사용하여 경계 상자를 정의하세요.

정규화된 값을 사용하면 위의 참조 이미지 행을 다음과 같이 표현할 수도 있습니다.
```
gs://example-reference-images/10001-001/10001-001_A.jpg,img001,sample-set-summer,sample-product-123,tan summer bag,apparel-v2,"style=womens,color=tan",0.10,0.15,0.45,0.15,0.45,0.55,0.10,0.55
gs://example-reference-images/10001-001/10001-001_A.jpg,img001,sample-set-summer,sample-product-456,blue summer bag,apparel-v2,"style=womens,color=blue",0.67,0.79,0.98,0.79,0.98,0.92,0.67,0.92
gs://example-reference-images/10002-002/10002-002_B.jpg,img002,sample-set-summer,sample-product-123,apparel-v2,,,
```