이 페이지에서는 프로그래매틱 방식으로 제품을 업로드하고 관리하는 방법을 설명합니다. Merchant Products API를 사용하면 데이터 소스에 제품을 삽입하거나 업데이트하고, 계정에서 제품을 검색하고, 데이터 소스에서 제품을 삭제할 수 있습니다.
Merchant Products API에는 두 가지 리소스가 포함되어 있습니다.
productInputs는 제품의 입력 부분을 나타냅니다.products는 입력 부품으로 구성된 처리된 제품을 나타냅니다.
productInputs는 기본 데이터 소스 또는 보조 데이터 소스에 업로드되는지에 따라 기본 또는 보조일 수 있습니다.
각 product는 단일 기본 productInput와 임의 개수의 보조 productInputs로 구성됩니다.
Merchant Products API를 사용하여 온라인 또는 오프라인 매장 카탈로그를 만들 수 있습니다. 이러한 카탈로그는 여러 쇼핑 대상 유형에 표시될 수 있는 제품입니다.
판매자 센터 계정을 만들고 첫 번째 데이터 소스를 설정했으며 API를 통해 초기 제품 세트를 업로드할 준비가 되면 productInputs 리소스를 사용할 수 있습니다.
판매자는 PrimaryProductDataSource라는 파일을 사용하여 제품을 업로드할 수 있지만 Merchant API를 사용하여 제품을 생성하고 삭제하면 여러 가지 이점이 있습니다. 이러한 이점에는 더 빠른 응답 시간과 대용량 파일을 관리할 필요 없이 실시간으로 제품을 업데이트할 수 있는 기능이 포함됩니다. API 호출로 이루어진 제품 변경사항이 쇼핑 데이터베이스에 표시되기까지 최대 몇 시간이 걸릴 수 있습니다.
기본 요건
데이터 소스가 없는 경우 판매자 DataSources API 또는 판매자 센터를 사용하여 데이터 소스를 만듭니다.
판매자 센터 UI 또는 API를 사용하여 만든 데이터 소스가 이미 있는 경우 Merchant Products API를 사용하여 제품을 추가할 수 있습니다. Content API for Shopping을 사용하여 제품을 추가하는 경우 이전 가이드에서 Merchant Products API를 시작하는 방법을 알아보세요.
쇼핑 광고 및 무료 등록정보 정책을 준수하는 것은 판매자의 책임입니다. 쇼핑 광고는 이러한 정책을 시행하고 이러한 정책을 위반하는 콘텐츠나 행동을 발견할 경우 적절하게 대응할 권리를 보유합니다.
리소스
products 리소스를 사용하면 쇼핑 데이터베이스에서 제품 정보를 가져올 수 있습니다.
productInput 리소스는 제품에 대해 제출하는 입력 데이터를 나타냅니다. 또한 일괄 모드에서 제품 정보를 한 번에 하나씩 또는 여러 개 업데이트하거나 삭제할 수 있는 메서드도 제공합니다. productInput 리소스에는 다음 필드가 있어야 합니다.
channel: 제품의 채널입니다.offerId: 제품의 고유 식별자입니다.contentLanguage: 제품의 두 글자 ISO 639-1 언어 코드입니다.feedLabel: 제품의 피드 라벨입니다.
계정에 제품 입력 업로드
제품 입력을 계정에 업로드하려면 accounts.productInputs.insert 메서드를 사용합니다. 기본 또는 보조 데이터 소스의 고유 식별자를 전달해야 합니다.
계정에서 처리된 제품 가져오기
계정에서 처리된 제품을 검색하려면 accounts.products.get 메서드를 사용하세요. 삽입 후 처리된 제품이 표시되기까지 몇 분 정도 걸릴 수 있습니다.
처리된 제품의 리소스 이름은 accounts.productInputs.insert의 응답에 있는 product 필드에서 가져올 수 있습니다.
계정에서 제품 입력 삭제하기
계정에서 제품 입력을 삭제하려면 accounts.productInputs.delete 메서드를 사용합니다. Merchant Products API를 사용하여 제품을 삭제하려면 제품이 속한 기본 또는 보조 데이터 소스의 고유 식별자를 전달해야 합니다.
계정의 제품 나열
계정에서 처리된 제품을 나열하려면 accounts.products.list 메서드를 사용합니다.