REST Resource: projects.locations.products

리소스: Product

Product에는 ReferenceImage가 포함되어 있습니다.

JSON 표현 
{
  "name": string,
  "displayName": string,
  "description": string,
  "productCategory": string,
  "productLabels": [
    {
      object (KeyValue)
    }
  ]
}
필드
name

string

제품의 리소스 이름입니다.

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

제품을 만들 때 이 필드는 무시됩니다.
displayName

string

이 Product에 사용자가 제공한 이름입니다. 비워 둘 수 없습니다. 4,096자(영문 기준) 이하여야 합니다.

description

string

이 제품에 저장할 사용자 제공 메타데이터입니다. 4,096자(영문 기준) 이하여야 합니다.

productCategory

string

변경할 수 없습니다. 참조 이미지로 식별되는 제품의 카테고리입니다. 'homegoods-v2', 'apparel-v2', 'toys-v2'여야 합니다. 기존 카테고리인 'homegoods', 'apparel', 'toys'는 계속 지원되지만 새 제품에 사용하지 않아야 합니다.

productLabels[]

object (KeyValue)

제품에 연결할 수 있는 키-값 쌍입니다. 쿼리 시 productLabels를 기반으로 제약조건을 지정할 수 있습니다.

정수 값은 문자열로 제공될 수 있습니다(예: '1199'). 정수 값이 있는 문자열만 곧 지원될 예정인 범위 기반 제한과 일치할 수 있습니다.

여러 값을 동일한 키에 할당할 수 있습니다. 제품 하나는 최대 500개의 productLabels를 포함할 수 있습니다.

하나의 ProductSet에 있는 모든 제품에 대한 개별 productLabels의 총 개수는 100만 개를 초과할 수 없습니다. 그렇지 않으면 제품 검색 파이프라인이 해당 ProductSet에 대한 작업을 거부합니다.

KeyValue

키-값 쌍으로 표시된 제품 라벨입니다.

JSON 표현 
{
  "key": string,
  "value": string
}
필드
key

string

제품에 연결된 라벨의 키입니다. 비워두면 안 되며 128바이트를 초과할 수 없습니다.

value

string

제품에 연결된 라벨의 값입니다. 비워두면 안 되며 128바이트를 초과할 수 없습니다.

메서드

create

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

delete

 제품 및 해당 참조 이미지를 영구적으로 삭제합니다.

get

 Product와 연결된 정보를 가져옵니다.

list

 지정되지 않은 순서로 제품을 나열합니다.

patch

 Product 리소스를 변경합니다.

purge

 ProductSet의 모든 Product 또는 ProductSet에 없는 모든 Product를 삭제하는 비동기 API입니다.