Method: projects.locations.productSets.import

이미지 정보 목록을 기반으로 지정된 제품 세트로 참고 이미지 목록을 가져오는 비동기 API입니다.

google.longrunning.Operation API를 사용하여 요청 진행 상태 및 결과를 추적할 수 있습니다. Operation.metadata에는 BatchOperationMetadata가 포함됩니다. (진행 상태) Operation.response에는 ImportProductSetsResponse가 포함됩니다. (결과)

이 메서드의 입력 소스는 Google Cloud Storage의 csv 파일입니다. csv 파일의 형식은 ImportProductSetsGcsSource.csv_file_uri를 참고하세요.

HTTP 요청

POST https://vision.googleapis.com/v1/{parent=projects/*/locations/*}/productSets:import

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
parent

string

필수 항목입니다. ProductSet를 가져올 프로젝트입니다.

형식: projects/PROJECT_ID/locations/LOC_ID

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "inputConfig": {
    object (ImportProductSetsInputConfig)
  }
}
필드
inputConfig

object (ImportProductSetsInputConfig)

필수 항목입니다. 요청 목록의 입력 콘텐츠입니다.

응답 본문

성공한 경우 응답 본문에 Operation의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

자세한 내용은 인증 개요를 참조하세요.

ImportProductSetsInputConfig

productSets.import 메서드의 입력 콘텐츠입니다.

JSON 표현 
{
  "gcsSource": {
    object (ImportProductSetsGcsSource)
  }
}
필드
gcsSource

object (ImportProductSetsGcsSource)

각 행에 ImportProductSetRequests 목록을 보관하는 csv 파일의 Google Cloud Storage 위치입니다.

ImportProductSetsGcsSource

각 행에 ImportProductSetRequests 목록을 보관하는 csv 파일의 Google Cloud Storage 위치입니다.

JSON 표현 
{
  "csvFileUri": string
}
필드
csvFileUri

string

입력 csv 파일의 Google Cloud Storage URI입니다.

URI는 gs://로 시작해야 합니다.

입력 csv 파일의 형식은 한 줄에 이미지 하나를 포함해야 합니다. 각 줄에는 8개의 열이 있습니다.

  1. image-uri
  2. image-id
  3. product-set-id
  4. product-id
  5. product-category
  6. product-display-name
  7. labels
  8. bounding-poly

image-uri, product-set-id, product-id, product-category 열이 필요합니다. 다른 모든 열은 선택사항입니다.

product-set-id 및 product-id 값으로 지정된 ProductSet 또는 Product가 없으면 시스템에서 이미지의 새 ProductSet 또는 Product를 만듭니다. 이 경우 product-display-name 열은 displayName을 참조하고 product-category 열은 productCategory를 참조하며 labels 열은 productLabels를 참조합니다.

image-id 열은 선택사항이지만 고유해야 합니다(제공할 경우). 비어 있으면 시스템에서 자동으로 고유 ID를 이미지에 할당합니다.

product-display-name 열은 선택사항입니다. 비어 있으면 시스템에서 제품의 displayName 필드를 공백(' ')으로 설정합니다. 나중에 API를 사용하여 displayName을 업데이트할 수 있습니다.

product-id가 있는 지정된 Product가 이미 있으면 시스템은 product-display-name, product-category, labels 열을 무시합니다.

labels 열(선택사항)은 다음과 같은 형식의 쉼표로 구분된 키-값 쌍 목록을 포함하는 행입니다.

"key_1=value_1,key_2=value_2,...,key_n=value_n"

bounding-poly 열(선택사항)은 referenceImages.create와 동일한 방식으로 이미지에서 관심 영역을 식별합니다. bounding-poly 열을 지정하지 않으면 시스템에서 자동으로 관심 리전을 인식합니다.

한 줄에 최대 1개의 bounding-poly 열이 허용됩니다. 이미지에 여러 관심 영역이 포함되어 있는 경우 동일한 제품 정보를 포함하는 행을 CSV 파일에 추가하고, 각 관심 영역의 bounding-poly 값을 추가합니다.

bounding-poly 열에는 'p1_x,p1_y,p2_x,p2_y,...,pn_x,pn_y' 형식의 쉼표로 구분된 짝수 개의 숫자가 포함되어야 합니다. 절대 경계 다각형의 경우 음수가 아닌 정수를, 정규화된 경계 다각형의 경우 [0, 1] 범위의 부동 소수점 값을 사용합니다.

이미지 해상도가 너무 커서(20MP 초과) 처리할 수 없으면 시스템이 이미지 크기를 조절합니다.