Przenieś zarządzanie produktami

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}