판매자 데이터 소스 API 개요

이 페이지에서는 제품을 삽입할 수 있습니다 자동화된 데이터 소스를 추가하면 Google에 제공합니다. 자동화된 데이터 소스는 웹사이트의 관련 제품에 대한 최신 정보가 Google에 도달합니다.

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

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

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

  • 특정 feedLabel로 새 기본 데이터 소스를 만듭니다. contentLanguage입니다.
  • 와일드 카드 데이터 소스를 만듭니다. 와일드 카드 데이터 소스에는 feedLabel이(가) 없습니다. 및 contentLanguage 필드가 설정되었습니다. 와일드 카드 데이터 소스를 사용하면 feedLabelcontentLanguage의 조합이 서로 다른 데이터 소스입니다
  • 보조 데이터 소스를 만들어 기존 기본 데이터 소스에 연결합니다.
  • 파일 데이터 소스의 일정을 설정합니다.
  • 데이터 소스를 자동으로 관리하려면 계정을 등록하세요.
  • API 데이터 소스 관리
  • 기본 제품 데이터 소스를 사용하여 데이터 소스의 기본 규칙을 관리합니다.
  • 프로모션과 같은 다른 유형의 데이터 소스를 사용합니다.

기본 요건

  • 계정이 단일 언어 피드로 이전된 상태여야 합니다.
  • 계정이 이미 데이터 대상 분할로 이전되었는지 확인하려면 다음을 사용합니다. 데이터 소스 목록 또는 가져오기 메서드와 같은 다른 속성을 지정할 수 있습니다. 자격요건을 충족하지 못한 경우 지원팀에 문의하시기 바랍니다.

    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 입력이 있는 데이터 소스만 와일드 카드 데이터 소스가 될 수 있습니다. 와일드 카드 데이터 소스는 파일 입력에 지원되지 않습니다.

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

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

보조 데이터 소스를 만들려면 다음을 사용하여 데이터 소스를 구성하세요. SupplementalProductDataSource한 다음 defaultRule를 업데이트하여 연결합니다. 필드가 추가됩니다

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

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

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

데이터 소스 소거

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

데이터 소스 가져오기

데이터 소스에 구성된 파일을 가져오려면 다음을 사용합니다. accounts.dataSources.fetch 드림 메서드를 사용하여 축소하도록 요청합니다. 이 메서드는 계정을 만들 수 있습니다. 이 방법은 파일 입력 세트가 있는 데이터 소스에서만 작동합니다.

데이터 소스 가져오기

계정의 데이터 소스 구성을 가져오려면 다음을 사용하세요. accounts.dataSources.get 드림 메서드를 사용하여 축소하도록 요청합니다.

데이터 소스 나열

계정의 데이터 소스 구성을 나열하려면 다음을 사용합니다. accounts.dataSources.list 드림 메서드를 사용하여 축소하도록 요청합니다.

데이터 소스 패치 적용

기존 데이터 소스의 구성을 업데이트하려면 다음을 사용합니다. accounts.dataSources.patch 드림 메서드를 사용하여 축소하도록 요청합니다.

기본 제품 데이터 소스를 사용하면 기본값을 관리할 수 있습니다. 데이터 소스 규칙. 기본 규칙은 속성을 찾습니다. 기본 규칙은 기본 규칙을 통해 기존 데이터 소스를 업데이트하여 데이터 소스 업데이트 필드를 확인합니다.

다음 샘플 구성은 모든 속성을 먼저 가져오도록 합니다. 고유 식별자 1001를 사용하여 데이터 소스에서 가져옵니다. 그런 다음 누락된 속성은 기본 데이터 소스에서 추가됩니다. 결국에는 속성은 고유 ID가 있는 보조 데이터 소스에서 가져옵니다. 다른 데이터 소스에서 아직 제공되지 않은 경우 식별자 1002입니다. 만약 속성이 여러 데이터 소스에 제공된 경우 목록에서 높은 값이 선택합니다.

defaultRule {
 takeFromDataSources: [
   '1001', // Supplemental product data source
   'self', //  Self reference to the primary data source
   '1002' // Supplemental product data source
 ]
}

피드 자동 관리

데이터 소스를 자동 관리하기 위해 계정을 등록하려면 다음을 수행해야 합니다. 있습니다.

  • 다음을 호출하여 계정이 등록에 적합한지 확인합니다. Accounts.AutofeedSettings.Get 메서드를 사용하여 지도 가장자리에 패딩을 추가할 수 있습니다.
  • 계정이 마켓이 아닌지 확인 계정을 선택합니다.

계정을 등록할 수 있게 되면 데이터 자동 관리를 사용 설정하는 Accounts.AutofeedSettings.Update 메서드 소스입니다 데이터 소스 자동 관리를 사용 설정하면 Google에서 자동으로 온라인 상점의 제품을 추가하고 제품을 항상 최신 상태로 유지하세요. Google 플랫폼에서 제공하고 있습니다

파일 업로드 상태 가져오기

파일, 가져오기 또는 스프레드시트로 데이터 소스의 상태를 가져오려면 다음 단계를 따르세요. FileUpload 서비스의 GET 메서드를 호출할 수 있습니다. 이 데이터가 입력될 때 비동기식으로 계산된 소스 처리가 완료되면 이름 식별자 latest를 사용합니다.

GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest

파일 업로드 상태에는 다음과 같은 제품 세부정보가 포함될 수 있습니다. 모든 잠재적 문제

파일이 업로드된 적이 없는 경우 파일 업로드 상태가 존재하지 않을 수 있습니다. 직후에 요청된 경우 파일 업로드 상태가 '처리 중' 상태가 될 수 있습니다. 파일이 업로드됩니다