판매자 데이터 소스 API 개요

이 페이지에서는 제품을 삽입할 수 있는 데이터 소스를 프로그래매틱 방식으로 만들고 업데이트하는 방법을 설명합니다. 자동화된 데이터 소스를 사용하면 제품 데이터를 Google에 더 쉽게 전송할 수 있습니다. 자동화된 데이터 소스를 사용하면 웹사이트의 관련 제품에 대한 최신 정보가 Google에 전달됩니다.

Content API for Shopping을 사용하면 기본 데이터 소스만 만들 수 있습니다. 판매자 데이터 소스 API를 사용하면 다음과 같은 유형의 데이터 소스를 만들 수 있습니다.

Content API for Shopping은 파일 입력이 있는 데이터 소스 관리만 허용했습니다. 판매자 API를 사용하면 파일 및 API 입력을 모두 사용하여 데이터 소스를 관리할 수 있습니다.

판매자 데이터 소스 API를 사용하면 다음을 수행할 수 있습니다.

  • 특정 feedLabelcontentLanguage를 사용하여 새 기본 데이터 소스를 만듭니다.
  • 와일드 카드 데이터 소스를 만듭니다. 와일드 카드 데이터 소스에는 feedLabelcontentLanguage 필드가 설정되지 않습니다. 와일드 카드 데이터 소스를 사용하면 feedLabelcontentLanguage의 다양한 조합으로 제품을 데이터 소스에 삽입할 수 있습니다.
  • 보조 데이터 소스를 만들어 기존 기본 데이터 소스에 연결합니다.
  • 파일 데이터 소스의 일정을 설정합니다.
  • API 데이터 소스 관리
  • 프로모션과 같은 다른 유형의 데이터 소스를 사용합니다.

기본 요건

  • 계정이 단일 언어 피드로 이전된 상태여야 합니다.
  • 계정이 이미 데이터 대상 분할로 이전되었는지 확인하려면 데이터 소스 목록 또는 get 메서드를 사용합니다. 자격이 없는 경우 다음과 같은 예외 메시지가 전송되며 지원팀에 문의해야 합니다.

    This account is in the data sources migration process and can't be used with
    this API yet. Contact support for more info on when this account will be able
    to use the data sources endpoint.
    

새 데이터 소스 만들기

특정 feedLabelcontentLanguage로 새 기본 데이터 소스를 만들려면 유형별 구성에서 feedLabelcontentLanguage 필드를 설정합니다. 예: PrimaryProductDataSource

새로 만든 데이터 소스를 보려면 GET 또는 LIST 요청을 만드세요.

새 와일드 카드 기본 데이터 소스 만들기

새 와일드 카드 기본 피드를 만들려면 PrimaryProductDataSource를 사용하여 데이터 소스를 구성하고 feedLabelcontentLanguage 필드를 설정하지 마세요.

Content API for Shopping을 사용하면 API 데이터 소스가 하나만 생성됩니다. 판매자 데이터 소스 API를 사용하면 여러 API 데이터 소스를 가질 수 있으며, 이 중 일부는 와일드 카드일 수 있습니다.

API 입력이 있는 데이터 소스만 와일드 카드 데이터 소스가 될 수 있습니다. 파일 입력에는 와일드 카드 데이터 소스가 지원되지 않습니다.

보조 데이터 소스를 만들어 기본 데이터 소스에 연결

보조 데이터 소스를 사용하면 accounts.productInputs.insertaccounts.productInputs.delete 메서드를 호출할 때 데이터 소스의 고유 식별자를 쿼리 매개변수로 추가하여 제품 데이터를 부분적으로 업데이트할 수 있습니다. 보조 데이터 소스는 기존 제품을 업데이트하는 데만 사용할 수 있습니다.

보조 데이터 소스를 만들려면 SupplementalProductDataSource를 사용하여 데이터 소스를 구성한 다음 기본 데이터 소스의 defaultRule 필드를 업데이트하여 연결합니다.

보조 파일 데이터 소스는 와일드 카드 데이터 소스일 수 없습니다. 보조 API 데이터 소스는 항상 와일드 카드 데이터 소스여야 합니다.

파일 데이터 소스의 일정 설정

파일 피드의 일정을 설정하려면 FileInput 필드를 사용하여 데이터 소스를 파일 데이터 소스로 구성한 다음 FileInput.FetchSettings 필드를 사용하여 fetchsettings를 설정합니다.

데이터 소스 소거

계정에서 기존 데이터 소스를 삭제하려면 accounts.dataSources.delete 메서드를 사용합니다.

데이터 소스 가져오기

데이터 소스에 구성된 파일을 가져오려면 accounts.dataSources.fetch 메서드를 사용합니다. 이 메서드는 계정의 데이터 소스에서 즉시 데이터를 가져옵니다. 이 방법은 파일 입력 세트가 있는 데이터 소스에서만 작동합니다.

데이터 소스 가져오기

계정의 데이터 소스 구성을 가져오려면 accounts.dataSources.get 메서드를 사용합니다.

데이터 소스 나열

계정의 데이터 소스 구성을 나열하려면 accounts.dataSources.list 메서드를 사용합니다.

데이터 소스 패치 적용

기존 데이터 소스의 구성을 업데이트하려면 accounts.dataSources.patch 메서드를 사용합니다.