Method: accounts.productInputs.insert

판매자 센터 계정에 제품 입력을 업로드합니다. 동일한 contentLanguage, offerId, dataSource가 있는 입력이 이미 있는 경우 이 메서드는 해당 항목을 바꿉니다.

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

HTTP 요청

POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert

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

경로 매개변수

매개변수
parent

string

필수 항목입니다. 이 제품이 삽입될 계정입니다. 형식: accounts/{account}

쿼리 매개변수

매개변수
dataSource

string

필수 항목입니다. 기본 또는 보조 제품 데이터 소스 이름입니다. 제품이 이미 있지만 제공된 데이터 소스가 다른 경우 제품이 새 데이터 소스로 이동됩니다. 형식: accounts/{account}/dataSources/{datasource}

요청 본문

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

응답 본문

이 리소스는 판매자 센터, 쇼핑 광고 또는 Google 플랫폼에 표시되는 처리된 제품이 아닌 제품에 제출한 입력 데이터를 나타냅니다. 제품 입력, 규칙, 보조 데이터 소스 데이터가 결합되어 처리된 [product][google.shopping.content.bundles.Products.Product]를 생성합니다.

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

필수 속성은 [feedLabel][google.shopping.content.bundles.Products.feed_label], [contentLanguage][google.shopping.content.bundles.Products.content_language] 및 [offerId][google.shopping.content.bundles.Products.offer_id]입니다.

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

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

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

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}}"
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일 후 제품 새로고침)할 수 있습니다.

기본 데이터 소스에 삽입할 때만 지원됩니다.

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

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/content

자세한 내용은 OAuth 2.0 개요를 참고하세요.