Z tej strony dowiesz się, jak przesyłać produkty i zarządzać nimi za pomocą programowania. Za pomocą interfejsu Merchant Products API możesz wstawiać produkty lub aktualizować je w źródle danych, pobierać produkty z konta oraz usuwać je z źródła danych.
Interfejs Merchant Products API zawiera 2 zasoby.
productInputsreprezentuje dane wejściowe Twoich produktów.productsreprezentuje przetworzone produkty, które zostały utworzone z podanych przez Ciebie części.
productInputs może być podstawowy lub dodatkowy, w zależności od tego, czy jest przesłany do podstawowego źródła danych czy do dodatkowego źródła danych.
Każdy element product będzie zbudowany z jednego podstawowego elementu productInput i dowolnej liczby dodatkowych elementów productInputs.
Interfejs Merchant Products API umożliwia tworzenie katalogów sklepów internetowych lub lokalnych. Są to produkty, które mogą się wyświetlać w wielu miejscach docelowych zakupów.
Zasób productInputs możesz użyć po utworzeniu konta Merchant Center, skonfigurowaniu pierwszego źródła danych i przesłaniu początkowego zestawu produktów za pomocą interfejsu API.
Chociaż sprzedawcy mogą przesyłać produkty za pomocą pliku o nazwie PrimaryProductDataSource, tworzenie i usuwanie produktów za pomocą interfejsu Merchant API ma kilka zalet. Zalety to m.in. szybszy czas reakcji i możliwość aktualizowania produktów w czasie rzeczywistym bez konieczności zarządzania dużymi plikami. Zanim zmiany produktów wprowadzone przez wywołania interfejsu API pojawią się w bazie danych Zakupów Google, może minąć do kilku godzin.
Wymagania wstępne
Jeśli nie masz źródła danych, utwórz je za pomocą Merchant DataSources API lub w Merchant Center.
Jeśli masz już źródło danych utworzone za pomocą interfejsu Merchant Center lub interfejsu API, możesz dodać produkty za pomocą interfejsu Merchant Products API. Jeśli dodajesz produkty za pomocą Content API for Shopping, zapoznaj się z przewodnikiem po migracji, aby dowiedzieć się, jak zacząć korzystać z interfejsu Merchant Products API.
Użytkownik jest odpowiedzialny za przestrzeganie zasad dotyczących reklam produktowych i bezpłatnych informacji. Zastrzegamy sobie prawo do egzekwowania tych zasad i podejmowania odpowiednich działań, jeśli wykryjemy treści lub zachowania, które są z nimi niezgodne.
Zasoby
Zasób products umożliwia pobieranie informacji o produktach z bazy danych Zakupów Google.
Zasób productInput reprezentuje dane wejściowe przesłane dla produktu. Zawiera też metody, które umożliwiają aktualizowanie lub usuwanie informacji o produktach pojedynczo lub wiele naraz w trybie zbiorczym. Zasób productInput musi zawierać te pola:
channel: kanał produktu.offerId: unikalny identyfikator produktu.contentLanguage: dwuliterowy kod języka ISO 639-1 produktu.feedLabel: etykieta pliku danych produktu.
Przesyłanie danych produktu na konto
Aby przesłać dane produktu na swoje konto, użyj metody accounts.productInputs.insert. Musisz podać unikalny identyfikator podstawowego lub dodatkowego źródła danych.
Pobieranie przetworzonego produktu z konta
Aby odzyskać przetworzony produkt z konta, użyj metody accounts.products.get. Po wstawieniu przetworzonego produktu może minąć kilka minut, zanim się pojawi.
Nazwę zasobu przetworzonego produktu możesz uzyskać z pola product w odpowiedzi na zapytanie accounts.productInputs.insert
Usuwanie danych o produkcie z konta
Aby usunąć dane produktu z konta, użyj metody accounts.productInputs.delete. Aby usunąć produkt za pomocą interfejsu Merchant Products API, musisz przekazać unikalny identyfikator podstawowego lub uzupełniającego źródła danych, do którego należy produkt.
Wyświetlanie listy produktów na koncie
Aby wyświetlić przetworzone produkty na swoim koncie, użyj metody accounts.products.list.