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
icontentLanguage
- Utwórz źródło danych z symbolem wieloznacznym. Źródło danych z symbolem wieloznacznym nie zawiera atrybutu
feedLabel
icontentLanguage
ustawione. Źródła danych z symbolami wieloznacznymi umożliwiają wstawianie produkty z różnymi kombinacjami atrybutówfeedLabel
icontentLanguage
, 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
]
}
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.