REST Resource: accounts.productInputs

리소스: ProductInput

이 리소스는 판매자 센터, 쇼핑 광고 또는 Google 플랫폼에 표시되는 처리된 제품이 아니라 제품에 대해 제출하는 입력 데이터를 나타냅니다. 제품 입력, 규칙, 보조 데이터 소스 데이터가 결합되어 처리된 Product가 생성됩니다.

데이터 유효성 검사를 통과하는 데 필요한 제품 입력 속성은 주로 제품 데이터 사양에 정의되어 있습니다.

feedLabel, contentLanguage, offerId 속성은 필수입니다.

제품 입력을 삽입, 업데이트 또는 삭제한 후 처리된 제품을 검색할 수 있기까지 몇 분 정도 걸릴 수 있습니다.

제품 입력란 및 하위 메시지의 모든 필드는 일부 예외를 제외하고 카테고리 사양의 해당 속성의 영어 이름과 일치합니다.

JSON 표현 
{
  "name": string,
  "product": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "versionNumber": string
}
필드
name

string

식별자. 제품 입력의 이름입니다. 형식: "{productinput.name=accounts/{account}/productInputs/{productinput}}", 여기서 마지막 섹션 productinput은 4개의 부분으로 구성됩니다. channel~contentLanguage~feedLabel~offerId 제품 입력 이름의 예는 'accounts/123/productInputs/online~en~US~sku123'입니다.
product

string

출력 전용입니다. 처리된 제품의 이름입니다. 형식: "{product.name=accounts/{account}/products/{product}}"
channel

enum (ChannelEnum)

변경할 수 없습니다. 제품의 채널입니다.
offerId

string

필수 항목입니다. 변경할 수 없습니다. 제품의 고유 식별자입니다. 이는 제품 입력과 처리된 제품에 동일하게 적용됩니다. 제출 시 선행 및 후행 공백이 제거되고 여러 공백은 단일 공백으로 대체됩니다. 자세한 내용은 제품 데이터 사양을 참고하세요.
contentLanguage

string

필수 항목입니다. 변경할 수 없습니다. 제품의 ISO 639-1 언어 코드(두 글자)입니다.
feedLabel

string

필수 항목입니다. 변경할 수 없습니다. 제품의 피드 라벨입니다.
attributes

object (Attributes)

선택사항입니다. 제품 속성 목록입니다.
customAttributes[]

object (CustomAttribute)

선택사항입니다. 맞춤 (판매자 제공) 속성 목록입니다. 또한 데이터 사양의 속성을 일반 형식 (예: { "name": "size type", "value": "regular" })으로 제출하는 데 사용할 수 있습니다. 이는 Buy on Google에 사용되는 추가 속성 등 API에 의해 명시적으로 노출되지 않는 속성을 제출하는 데 유용합니다. 각 맞춤 속성의 최대 허용 문자 수는 10,240자(영문 기준)입니다(이름과 값의 문자 수 합계를 나타냄). 제품당 최대 2, 500개의 맞춤 속성을 설정할 수 있으며 총 크기는 102.4KB입니다. 맞춤 속성 이름의 밑줄은 삽입 시 공백으로 대체됩니다.
versionNumber

string (int64 format)

선택사항입니다. 제품의 기존 버전 (최신성)을 나타냅니다. 이 버전은 여러 업데이트가 동시에 실행될 때 올바른 순서를 유지하는 데 사용할 수 있습니다.

이 속성을 설정하면 버전 번호가 기존 제품의 현재 버전 번호보다 낮은 경우 삽입이 방지됩니다. 현재 versionNumber를 사용하여 재삽입 (예: 30일 후 제품 업데이트)을 실행할 수 있습니다.

기본 데이터 소스에 삽입하는 경우에만 지원됩니다.

작업이 방지되면 중단된 예외가 발생합니다.

메서드

delete

 판매자 센터 계정에서 제품 입력을 삭제합니다.

insert

 판매자 센터 계정에 제품 입력을 업로드합니다.