판매자 센터 계정에 제품 입력을 업로드합니다. 동일한 contentLanguage, offerId, dataSource가 있는 입력이 이미 있는 경우 이 메서드는 해당 항목을 바꿉니다.
제품 입력을 삽입, 업데이트 또는 삭제한 후 처리된 제품을 가져올 수 있기까지 몇 분 정도 걸릴 수 있습니다.
HTTP 요청
POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
parent |
필수 항목입니다. 이 제품이 삽입될 계정입니다. 형식: accounts/{account} |
쿼리 매개변수
매개변수 | |
---|---|
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 ( |
필드 | |
---|---|
name |
식별자. 제품 입력의 이름입니다. 형식: |
product |
출력 전용입니다. 처리된 제품의 이름입니다. 형식: |
channel |
필수 항목입니다. 변경할 수 없습니다. 제품의 채널입니다. |
offerId |
필수 항목입니다. 변경할 수 없습니다. 제품의 고유 식별자입니다. 이는 입력된 제품 및 처리된 제품에서 동일합니다. 선행 및 후행 공백은 제거되며, 제출 시 여러 공백은 단일 공백으로 대체됩니다. 자세한 내용은 제품 데이터 사양을 참조하세요. |
contentLanguage |
필수 항목입니다. 변경할 수 없습니다. 제품의 두 글자 ISO 639-1 언어 코드입니다. |
feedLabel |
필수 항목입니다. 변경할 수 없습니다. 제품의 피드 라벨입니다. |
attributes |
선택사항입니다. 제품 속성의 목록입니다. |
customAttributes[] |
선택사항입니다. 맞춤 (판매자 제공) 속성의 목록입니다. 데이터 사양의 속성을 일반 형식으로 제출하는 데에도 사용할 수 있습니다 (예: |
versionNumber |
선택사항입니다. 제품의 기존 버전 (최신 버전)을 나타내며, 여러 업데이트가 동시에 실행될 때 올바른 순서를 유지하는 데 사용할 수 있습니다. 설정하면 버전 번호가 기존 제품의 현재 버전 번호보다 낮을 때 삽입이 차단됩니다. 현재 기본 데이터 소스에 삽입할 때만 지원됩니다. 작업이 방지되면 취소된 예외가 발생합니다. |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/content
자세한 내용은 OAuth 2.0 개요를 참고하세요.