Za pomocą interfejsu Merchant API możesz przesyłać produkty i zarządzać nimi w sposób programowy. Zasób accounts.products
umożliwia utworzenie katalogu sklepu internetowego, czyli listy produktów i ofert. Więcej informacji o przesyłaniu produktów i zarządzaniu nimi za pomocą Merchant API znajdziesz w artykule Omówienie interfejsu Merchant Products API.
Zmiany zasobów
Zasoby products
i productstatuses
interfejsu Content API są zastępowane zasobami productInputs
i products
.
Aby przesłać informacje o produktach, możesz użyć zasobu productInputs
interfejsu Merchant API. Zasób product
interfejsu Merchant API może służyć do pobierania przetworzonych produktów, w tym ich stanów.
Wymagania dotyczące źródła danych
Podczas przesyłania produktów w Merchant API musisz podać docelowe źródło danych. Może to być podstawowe źródło danych lub dodatkowe źródło danych. Możesz pobrać istniejące źródła danych za pomocą funkcji dataSources.list lub utworzyć nowe źródło danych za pomocą funkcji dataSources.create.
Możesz też zarządzać źródłami danych za pomocą interfejsu Merchant Center.
Więcej informacji o źródłach danych oraz o tym, jak je tworzyć i nimi zarządzać, znajdziesz w artykule Omówienie interfejsu Merchants Data sources API.
Zmiany identyfikatorów
Interfejs Merchant API używa atrybutu name do identyfikowania produktu. Nazwa produktu będzie mieć format accounts/{account}/products/{product}
, gdzie {product}
ma format channel~language~feedLabel~offerId
.
Zasoby Content API używają :
zamiast ~
między każdą wartością w polu identyfikator:channel:language:feedLabel:offerId
.
Wszystkie wywołania interfejsu Merchant API zwracają nowy format z znakami ~
między wartościami identyfikatora. Zalecamy zapisanie nowego pola name
z odpowiedzi i używanie go w przyszłych wywołaniach.
Metody
Oto porównanie metod produktów w Content API for Shopping i Merchant Products API:
Content API for Shopping | Merchant Products API |
---|---|
products.custombatch | Niedostępne |
products.insert | productInputs.insert |
products.update | Jeszcze niedostępny |
products.delete | productInputs.delete |
products.get | products.get |
products.list | products.list |
productstatuses.custombatch | Niedostępne |
productstatuses.get | products.get |
productstatuses.list | products.list |
Żądania
Metoda Content API | Adres URL w Content API for Shopping | Adres URL w interfejsie Merchant Products API | Identyfikator w Content API | Identyfikator w interfejsie Merchant Products API |
---|---|---|---|---|
products.insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/products |
POST https://merchantapi.googleapis.com/products/v1beta/ {PARENT}/productsInputs:insert?dataSource=accounts/ {MERCHANT_ID}/dataSources/ {DATASOURCE_ID} |
MERCHANT_ID | PARENT=accounts/{MERCHANT_ID} |
products.update |
PATCH https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/products/ {PRODUCT_ID} |
Niedostępne | ||
products.delete |
DELETE https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/products/ {PRODUCT_ID} |
DELETE https://merchantapi.googleapis.com/products/v1beta/ {NAME}?dataSource=accounts/ {MERCHANT_ID}/dataSources/ {DATASOURCE_ID} |
MERCHANT_ID, PRODUCT_ID | NAME=accounts/{MERCHANT_ID}/productInputs/{PRODUCT_ID_WITH_TILDES} |
products.get |
GET https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/products/ {PRODUCT_ID} |
GET https://merchantapi.googleapis.com/products/v1beta/ {NAME} |
MERCHANT_ID, PRODUCT_ID | NAME=accounts/{MERCHANT_ID}/products/{PRODUCT_ID_WITH_TILDES} |
products.list |
GET https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/products |
GET https://merchantapi.googleapis.com/products/v1beta/ {PARENT}/products |
MERCHANT_ID | PARENT=accounts/{MERCHANT_ID} |
productstatuses.get |
GET https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/productstatuses/ {PRODUCT_ID} |
GET https://merchantapi.googleapis.com/products/v1beta/ {NAME} |
MERCHANT_ID, PRODUCT_ID | NAME=accounts/{MERCHANT_ID}/products/{PRODUCT_ID_WITH_TILDES} |
productstatuses.list |
GET https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/productstatuses |
GET https://merchantapi.googleapis.com/products/v1beta/ {PARENT}/products |
MERCHANT_ID | PARENT=accounts/{MERCHANT_ID} |