Omówienie interfejsu Merchant Products API

Na tej stronie wyjaśniamy, jak przesyłać produkty i zarządzać nimi w sposób zautomatyzowany. Za pomocą interfejsu Merchant Products API możesz wstawić lub zaktualizować produkt w źródle danych, pobrać go z konta i usunąć ze źródła danych.

Możesz użyć zasobu products, aby utworzyć katalog sklepu internetowego, który zawiera listę produktów dostępnych w reklamach produktowych. Możesz użyć zasobu products, gdy utworzysz konto Merchant Center i prześlesz wstępny zestaw produktów za pomocą interfejsu API.

Ponosisz odpowiedzialność za przestrzeganie zasad dotyczących reklam produktowych i bezpłatnych informacji. Reklamy produktowe zastrzegamy sobie prawo do egzekwowania tych zasad i odpowiedniego reagowania, jeśli zauważymy treści lub zachowania, które naruszają te zasady.

Zasób products przesyła informacje o produktach do bazy danych Shopping Merchant Center. Zapewnia też wiele metod, które pozwalają wyświetlać, aktualizować i usuwać informacje o produkcie pojedynczo lub zbiorczo w trybie zbiorczym.

Zasób productInput reprezentuje dane wejściowe produktu, które przesyłasz. Zasób productInput musi zawierać te pola:

  • channel: kanał produktu.
  • offerId: unikalny identyfikator produktu. Ta wartość jest taka sama w przypadku danych wejściowych produktu i przetworzonego produktu.
  • contentLanguage: dwuliterowy kod języka produktu w formacie ISO 639-1.
  • feedLabel: etykieta pliku danych produktu.

Chociaż sprzedawcy mogą wczytywać produkty za pomocą pliku o nazwie podstawowy plik danych, tworzenie i usuwanie produktów za pomocą interfejsu Merchant API ma kilka zalet. Zaletą tej metody jest krótszy czas odpowiedzi i możliwość aktualizowania wielu produktów w czasie rzeczywistym bez konieczności zarządzania wieloma dodatkowymi plikami danych. Zanim zmiany produktu wprowadzone przez wywołania interfejsu API pojawią się w bazie danych Merchant Center, może minąć kilka godzin.

Google może pomóc Ci automatycznie zachować niektóre atrybuty produktów. Więcej informacji znajdziesz w artykule o włączaniu automatycznych poprawek.

Wymagania wstępne

Jeśli nie masz źródła danych, utwórz je za pomocą interfejsu Merchant Datasources API lub Merchant Center.

Jeśli masz już źródło danych utworzone za pomocą interfejsu użytkownika Merchant Center lub interfejsu API, możesz dodać swoje 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.

Prześlij dane wejściowe produktu na swoje konto

Aby przesłać na konto dane wejściowe produktu, użyj metody accounts.productInputs.insert. Aby wstawić produkt za pomocą interfejsu Merchant Products API, musisz przekazać unikalny identyfikator podstawowego lub uzupełniającego źródła danych.

Pobierz przetworzony produkt ze swojego konta

Aby pobrać ze swojego konta przetworzony produkt, użyj metody accounts.products.get. Może minąć kilka minut, zanim przetworzony produkt pojawi się po wstawieniu.

Usuwanie danych wejściowych produktu z konta

Aby usunąć ze swojego konta dane wejściowe produktu, użyj metody accounts.productInputs.delete. Aby usunąć produkt, za pomocą interfejsu Merchant Products API musisz przekazać unikalny identyfikator podstawowego lub dodatkowego źródła danych, którego dotyczy produkt.

Wyświetl listę produktów ze swojego konta

Aby wyświetlić listę przetworzonych produktów na koncie, użyj metody accounts.products.list.