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:

• Główne źródła danych o produktach
• Dodatkowe źródła danych produktów
• Źródła danych lokalnego asortymentu
• Źródła danych o regionalnym asortymencie
• Źródła danych o promocjach

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.
• Zarejestruj swoje konto, aby automatycznie zarządzać źródłami danych.
• Zarządzaj źródłami danych interfejsu API.
• Zarządzaj domyślną regułą źródeł danych za pomocą głównych źródeł danych o produktach.
• 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.

Korzystając 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 .

Połącz źródła danych

Główne źródła danych o produktach umożliwiają zarządzanie domyślnymi źródłami danych reguły źródeł danych. Reguła domyślna dotyczy wszystkich w swoim źródle danych. Domyślną regułę można ustawić podczas tworzenia źródła danych lub przez aktualizację istniejącego źródła danych za pomocą reguły domyślnej .

Poniższa przykładowa konfiguracja zapewnia, że wszystkie atrybuty są stosowane w pierwszej kolejności ze źródła danych o unikalnym identyfikatorze 1001. Następnie brakujące są dodawane z podstawowego źródła danych. Ostatecznie pozostałe zostaną pobrane z dodatkowego źródła danych z unikalnym parametrem identyfikator 1002, jeśli nie został jeszcze podany w żadnym innym źródle danych. Jeśli taki sam występuje w wielu źródłach danych, im wyższa wartość na liście, zaznaczono.

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

Uwaga: reguł niestandardowych nie można modyfikować za pomocą interfejsu API.

Automatyczne zarządzanie plikami danych

Aby zarejestrować swoje konto do automatycznego zarządzania źródłami danych, musisz wykonać te czynności: :

• Sprawdź, czy Twoje konto kwalifikuje się do rejestracji, dzwoniąc do Metoda Accounts.AutofeedSettings.Get.
• Upewnij się, że Twoje konto nie jest platformą handlową .

Gdy Twoje konto będzie się kwalifikować do rejestracji, możesz korzystać z aplikacji Metoda Accounts.AutofeedSettings.Update, która umożliwia automatyczne zarządzanie danymi źródeł. Włączenie automatycznego zarządzania źródłami danych pozwala Google automatycznie dodaj produkty ze sklepu internetowego i zadbaj o to, aby były zawsze aktualne na platformach Google.

Pobieranie stanu przesyłania pliku

Aby sprawdzić stan źródła danych za pomocą pliku, pobierania lub arkusza kalkulacyjnego: może wywołać metodę GET usługi FileUpload. Aby uzyskać wynik funkcji ostatniego pobrania źródła danych obliczonego asynchronicznie, gdy dane przetwarzanie źródła zostało zakończone, użyj identyfikatora nazwy latest.

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

Stan przesyłania pliku może zawierać szczegółowy widok produktów, w tym wszystkich potencjalnych problemów.

Pamiętaj, że stan przesyłania pliku może nie istnieć, jeśli plik nie został przesłany. Stan przesyłania pliku może być w stanie przetwarzania, jeśli zostanie wysłana wkrótce po tej prośbie plik został przesłany.