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 źródła danych ułatwiają przesyłanie danych produktów do Google. Automatyczne źródła danych dbają o to, aby Google otrzymywało najbardziej aktualne informacje o odpowiednich produktach z Twojej witryny.

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 umożliwia zarządzanie źródłami danych tylko za pomocą plików wejściowych. Interfejs Merchant API umożliwia zarządzanie źródłami danych za pomocą plików i danych wejściowych interfejsu API.

Za pomocą interfejsu Merchant Data sources API możesz:

  • Utwórz nowe podstawowe źródło danych z określonymi parametrami feedLabel i contentLanguage
  • Utwórz źródło danych, w którym nie są ustawione pola feedLabel i contentLanguage. Za pomocą tego typu źródła danych możesz kierować swoje produkty na wiele krajów, ponieważ możesz wstawić produkty z różnymi kombinacjami feedLabel i contentLanguage do jednego źródła danych.
  • Utwórz dodatkowe źródło danych, aby połączyć je z dotychczasowym 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.

Nie można używać interfejsu Merchant API do wstawiania produktów do źródła danych, które zawiera produktów dostępnych lokalnie i online. Więcej informacji o źródłach danych kanałów, patrz Kanały.

Wymagania wstępne

  • Twoje konto musi zostać przeniesione do plików danych w jednym języku.

  • Aby sprawdzić, czy konto zostało już przeniesione do podziału na docelowe dane, użyj listy źródeł danych lub metod get. Jeśli nie spełniasz wymagań, otrzymasz następujący komunikat o wyjątku i musisz skontaktować 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

Podstawowe źródła danych to główne źródła danych o asortymencie produktów w Merchant Center. Produkty możesz dodawać i usuwać tylko za pomocą podstawowego źródła danych. Jeśli każdy produkt dodany do podstawowego źródła danych spełnia wymagania Merchant Center dotyczące danych i wyświetlania, nie musisz tworzyć kolejnych źródeł 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. Aby dowiedzieć się więcej o tych polach, zobacz PrimaryProductDataSource.

Więcej informacji o tworzeniu źródła danych: accounts.dataSources.create .

Aby wyświetlić nowo utworzone źródło danych, użyj metody accounts.dataSources.get lub accounts.dataSources.list.

Tworzenie nowego podstawowego źródła danych, które ułatwia kierowanie reklam na wiele krajów

Aby utworzyć nowy podstawowy plik danych, który pomoże Ci kierować reklamy na wiele krajów, skonfiguruj źródło danych za pomocą pola PrimaryProductDataSource i nie ustawiaj pól feedLabel ani contentLanguage.

W przypadku Content API for Shopping jest tworzone tylko jedno źródło danych API. Za pomocą interfejsu Merchant Data sources API możesz mieć wiele źródeł danych API, w których niektóre pola, takie jak feedLabel i contentLanguage, mogą być puste.

Tylko źródła danych z danymi wejściowymi interfejsu API mogą nie zawierać elementów feedLabel i Ustawiono contentLanguage pól. Ten typ źródeł danych nie jest obsługiwany w przypadku danych wejściowych typu plik.

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

Dodatkowe źródła danych służą tylko do aktualizowania danych produktów, które są już występuje w co najmniej 1 podstawowym źródle danych. Możesz mieć kilka dodatkowych źródeł danych, przy czym każde z nich może uzupełniać dane w dowolnej liczbie podstawowych danych źródeł.

Za pomocą dodatkowych źródeł danych możesz wprowadzać częściowe zmiany w danych produktów, dodając niepowtarzalny identyfikator źródła danych jako parametr zapytania podczas wywoływania metod accounts.productInputs.insert i accounts.productInputs.delete. Źródeł danych uzupełniających możesz używać tylko do aktualizowania istniejących produktów.

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

Dodatkowe źródła danych plików muszą zawierać te identyfikatory: feedLabel i contentLanguage pola. W przypadku dodatkowych źródeł danych interfejsu API pola feedLabel i contentLanguage muszą być zawsze puste.

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 umożliwia natychmiastowe pobieranie danych ze źródła danych na Twoim koncie. Ta metoda działa tylko w przypadku źródeł danych ze zbiorem danych wejściowych plików.

Pobieranie ź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 accounts.dataSources.list .

Zastosowanie poprawki do źródła danych

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

Podstawowe źródła danych o produktach umożliwiają zarządzanie domyślną regułą ź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żej znajduje się przykładowa konfiguracja, która zapewnia, że wszystkie atrybuty są pobierane najpierw ze źródła danych o wyjątkowym 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 ten sam atrybut jest podany w kilku źródłach danych, wybrana jest wartość znajdująca się wyżej na liście.

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

Automatyczne zarządzanie plikami danych

Aby zarejestrować konto na potrzeby automatycznego zarządzania źródłami danych:

Gdy Twoje konto spełnia wymagania dotyczące rejestracji, możesz użyć metody accounts.autofeedSettings.updateAutofeedSettings, aby włączyć automatyczne zarządzanie źródłami danych. Włączenie automatycznego zarządzania źródłami danych pozwala Google automatycznie dodawać produkty ze sklepu internetowego i dbać o to, aby były zawsze aktualne na platformach Google.

Pobieranie stanu przesyłania pliku

Aby uzyskać stan źródła danych z pliku, funkcji pobierania lub arkusza kalkulacyjnego, możesz wywołać metodę GET usługi accounts.dataSources.fileUploads. Aby uzyskać wynik ostatniego wyszukiwania źródła danych obliczonego asynchronicznie po zakończeniu przetwarzania, użyj nazwy identyfikator latest.

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

Stan przesyłania pliku może zawierać szczegółowy widok Twoich produktów, w tym ewentualne problemy.

Pamiętaj, że stan przesyłania pliku może nie być widoczny, jeśli plik nie został przesłany. Jeśli prośba została wysłana wkrótce po przesłaniu pliku, jego stan może być „w trakcie przetwarzania”.