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