Omówienie interfejsu Merchant Data Source API

Na tej stronie dowiesz się, jak automatycznie tworzyć i aktualizować źródła danych, które umożliwiają wstawianie produktów. Automatyczne dane ułatwiają wysyłanie informacji Twoich danych o produktach do Google. Zautomatyzowane źródła danych gwarantują, że aktualne informacje o odpowiednich produktach w Twojej witrynie docierają do Google.

Content API for Shopping umożliwia tworzenie tylko podstawowych źródeł danych. Na 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 parametrami feedLabel i contentLanguage
  • Utwórz źródło danych z symbolem wieloznacznym. Źródło danych z symbolem wieloznacznym nie zawiera atrybutu feedLabel i contentLanguage ustawione. Źródła danych z symbolami wieloznacznymi umożliwiają wstawianie produkty z różnymi kombinacjami atrybutów feedLabel i contentLanguage, w których źródła danych.
  • 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 źródła danych lub metod pobierania. Jeśli nie spełniasz wymagań, otrzymasz ten 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 parametrami feedLabel i contentLanguage ustaw pola feedLabel i contentLanguage w konfigurację konkretnego 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ą PrimaryProductDataSource i nie ustawiaj pól feedLabel i contentLanguage.

W przypadku korzystania z Content API for Shopping utworzono tylko jedno źródło danych API dla do Ciebie. Korzystając z interfejsu Merchant Data Source API, możesz mieć wiele źródeł danych API, niektóre z nich mogą być symbolami wieloznacznymi.

Źródłami danych z symbolami wieloznacznymi mogą być tylko źródła danych z danymi wejściowymi interfejsu API. Dane z symboli wieloznacznych źródeł nie są obsługiwane w przypadku danych wejściowych pliku.

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

Za pomocą dodatkowych źródeł danych możesz wprowadzić częściowe zmiany w danych produktów według dodając unikalny identyfikator źródła danych jako parametr zapytania połączenia do accounts.productInputs.insert oraz 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 następnie połącz ją, aktualizując defaultRule w podstawowym źródle danych.

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

Konfigurowanie harmonogramu źródła danych pliku

Aby skonfigurować harmonogram pliku danych, skonfiguruj źródło danych jako plik źródła danych, używając 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, skorzystaj z accounts.dataSources.delete .

Źródło danych pobierania

Aby pobrać plik skonfigurowany w źródle danych, użyj metody accounts.dataSources.fetch . Ta metoda wykonuje pobieranie danych bezpośrednio ze źródła danych z: swoje konto. 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 koncie, użyj accounts.dataSources.get .

Wyświetlanie listy źródeł danych

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

Zastosowanie poprawki do źródła danych

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