Method: projects.locations.products.referenceImages.create

새 ReferenceImage 리소스를 만들고 반환합니다.

boundingPoly 필드는 선택사항입니다. boundingPoly를 지정하지 않으면 시스템이 상위 제품의 productCategory와 호환되는 이미지에서 관심 리전을 감지합니다. 이를 지정하면 감지를 항상 건너뜁니다. 시스템에서 다각형을 회전되지 않은 직사각형으로 변환합니다.

이미지 해상도가 너무 커서(50MP 초과) 처리할 수 없으면 파이프라인이 이미지 크기를 조절합니다.

발생 가능한 오류:

  • imageUri가 없거나 4,096자(영문 기준)를 초과하면 INVALID_ARGUMENT를 반환합니다.
  • product가 없으면 INVALID_ARGUMENT를 반환합니다.
  • boundingPoly가 제공되지 않고 상위 제품의 productCategory와 호환되지 않는 항목이 없으면 INVALID_ARGUMENT를 반환합니다.
  • boundingPoly에 10개를 초과하는 다각형이 포함되어 있으면 INVALID_ARGUMENT를 반환합니다.

HTTP 요청

POST https://vision.googleapis.com/v1p3beta1/{parent=projects/*/locations/*/products/*}/referenceImages

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

경로 매개변수

매개변수
parent

string

참조 이미지를 만들 제품의 리소스 이름입니다.

형식은 projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID입니다.

쿼리 매개변수

매개변수
referenceImageId

string

참조 이미지를 추가할 사용자 제공 리소스 ID입니다. 이 값을 설정하면 서버에서 리소스 ID로 이 값을 사용합니다. 이미 사용 중인 경우 ALREADY_EXISTS 코드와 함께 오류가 반환됩니다. 128자(영문 기준) 이하여야 합니다. / 문자를 포함할 수 없습니다.

요청 본문

요청 본문에 ReferenceImage의 인스턴스가 포함됩니다.

응답 본문

성공한 경우 응답 본문에 새로 생성된 ReferenceImage의 인스턴스가 포함됩니다.

승인 범위

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

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

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