Omówienie interfejsu Merchant Data Source API

Na tej stronie dowiesz się, jak automatycznie tworzyć i aktualizować źródła danych umożliwiające wstawianie produktów. Automatyczne źródła danych ułatwiają przesyłanie danych produktów do Google. Automatyczne źródła danych dbają o to, aby do Google trafiały najbardziej aktualne informacje o odpowiednich produktach z Twojej witryny.

Content API for Shopping umożliwia tworzenie tylko podstawowych źródeł danych. Za pomocą interfejsu API źródeł danych sprzedawcy możesz tworzyć te typy źródeł danych:

Content API for Shopping zezwalało tylko na zarządzanie źródłami danych z danymi wejściowymi pliku. Interfejs Merchant API umożliwia zarządzanie źródłami danych z danymi wejściowymi dotyczącymi plików i interfejsu API.

Korzystając z interfejsu API źródeł danych sprzedawcy, możesz:

  • Utwórz nowe podstawowe źródło danych z określonymi właściwościami feedLabel i contentLanguage.
  • Utwórz źródło danych z symbolem wieloznacznym. Źródło danych z symbolem wieloznacznym nie ma ustawionych pól feedLabel i contentLanguage. Źródła danych z symbolami wieloznacznymi umożliwiają wstawianie do źródła danych produktów z różnymi kombinacjami atrybutów feedLabel i contentLanguage.
  • Utwórz dodatkowe źródło danych, aby połączyć je z istniejącym podstawowym źródłem danych.
  • Skonfiguruj harmonogram źródła danych plików.
  • Zarządzaj źródłami danych interfejsu API.
  • Użyj innych typów źródeł danych, np. promocji.

Wymagania wstępne

  • Twoje konto musi zostać przeniesione do plików danych dla jednego języka.

  • Aby sprawdzić, czy konto zostało już przeniesione do podziału miejsca docelowego danych, użyj listy źródeł danych lub pobierz metody. Jeśli ich nie spełniasz, otrzymasz taki komunikat o wyjątku. Skontaktuj się z zespołem pomocy.

    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.

Tworzenie nowego źródła danych

Aby utworzyć nowe podstawowe źródło danych z określonymi właściwościami feedLabel i contentLanguage, ustaw pola feedLabel i contentLanguage w konfiguracji zależnej od typu. Na przykład: PrimaryProductDataSource.

Aby wyświetlić nowo utworzone źródło danych, utwórz żądanie GET lub LIST.

Utwórz nowe główne źródło danych z symbolem wieloznacznym

Aby utworzyć nowy podstawowy plik danych z symbolem wieloznacznym, skonfiguruj źródło danych za pomocą parametru PrimaryProductDataSource i nie ustawiaj pól feedLabel ani contentLanguage.

Gdy korzystasz z Content API for Shopping, masz utworzone tylko jedno źródło danych API. Korzystając z interfejsu Merchant Data Source API, możesz mieć wiele źródeł danych interfejsu API, z których niektóre mogą zawierać symbole wieloznaczne.

Źródłami danych z symbolami wieloznacznymi mogą być tylko źródła danych z danymi wejściowymi interfejsu API. Źródła danych z symbolem wieloznacznym nie są obsługiwane w przypadku danych wejściowych plików.

Utwórz dodatkowe źródło danych i połącz je z podstawowym źródłem danych

Możesz używać dodatkowych źródeł danych do częściowych aktualizacji danych produktów, dodając unikalny identyfikator źródła danych jako parametr zapytania przy wywołaniach metod accounts.productInputs.insert i accounts.productInputs.delete. Do aktualizowania dotychczasowych produktów możesz używać tylko dodatkowych źródeł danych.

Aby utworzyć dodatkowe źródło danych, skonfiguruj źródło danych za pomocą SupplementalProductDataSource, a potem połącz je, aktualizując pole defaultRule w podstawowym źródle danych.

Dodatkowe źródła danych plików nie mogą być źródłami danych z symbolami wieloznacznymi. Dodatkowe źródła danych interfejsu API muszą zawsze być źródłami danych z symbolem wieloznacznym.

Konfigurowanie harmonogramu źródła danych pliku

Aby skonfigurować harmonogram pliku danych o plikach, skonfiguruj źródło danych jako źródło danych plików. W tym celu użyj pola FileInput, a potem skonfiguruj fetchsettings za pomocą pola FileInput.FetchSettings.

Usuwanie źródła danych

Aby usunąć z konta dotychczasowe źródło danych, użyj metody accounts.dataSources.delete.

Źródło danych pobierania

Aby pobrać plik skonfigurowany w źródle danych, użyj metody accounts.dataSources.fetch. Ta metoda powoduje natychmiastowe pobranie danych z Twojego konta do źródła danych. Ta metoda działa tylko w przypadku źródeł danych z zestawem danych wejściowych pliku.

Pobranie źródła danych

Aby pobrać konfigurację źródła danych na swoim koncie, użyj metody accounts.dataSources.get.

Wyświetlanie listy źródeł danych

Aby wyświetlić listę konfiguracji źródeł danych na koncie, użyj metody accounts.dataSources.list.

Zastosowanie poprawki do źródła danych

Aby zaktualizować konfigurację dotychczasowego źródła danych, użyj metody accounts.dataSources.patch.