Przenieś zarządzanie produktami

Za pomocą interfejsu Merchant API możesz przesyłać produkty i zarządzać nimi za pomocą kodu. Zasób accounts.products umożliwia tworzenie katalogu sklepu internetowego, czyli listy produktów i ofert. Więcej informacji o przesyłaniu produktów i zarządzaniu nimi za pomocą interfejsu 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 API sprzedawcy. Zasób Merchant API product służy do pobierania przetworzonych produktów, w tym ich stanów. Można go pobrać dopiero kilka minut po wstawieniu productInputs.

Uwaga: wszystkie standardowe metody, takie jak insert, update i delete, są dostępne tylko w przypadku metod productInputs, a metoda read tylko w przypadku product.

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ć dotychczasowe źródła danych za pomocą funkcji dataSources.list lub utworzyć nowe źródło danych za pomocą funkcji dataSources.create.

Uwaga: źródło danych jest dostępne od razu po utworzeniu, więc nie musisz czekać na przetworzenie.

Możesz też zarządzać źródłami danych za pomocą interfejsu Merchant Center.

Więcej informacji o źródłach danych i 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 identyfikatorów. 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. Zamiast tego użyj prośby zbiorczej.
products.insert	productInputs.insert
products.update	productInputs.patch
products.update	productInputs.patch
products.delete	productInputs.delete
products.get	products.get
products.list	products.list
productstatuses.custombatch	Niedostępne. Zamiast tego użyj prośby zbiorczej.
productstatuses.get	products.get
productstatuses.list	products.list

Uwaga: wszystkie metody create, update i delete są wykonywane tylko w zasobie productInput. Dodatkowo do zasobu produktu dodano metody productstatuses.

Żądania

Metoda Content API	Adres URL w Content API for Shopping	Adres URL 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}
products.update	PATCH https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}	PATCH https://merchantapi.googleapis.com/products/v1beta/{productInput.name=accounts/*/productInputs/*}	PATCH https://merchantapi.googleapis.com/products/v1beta/account/{ACCOUNT_ID}/productInputs/{PRODUCT_ID}	MERCHANT_ID, PRODUCT_ID	NAME=accounts/{ACCOUNT_ID}/productInputs/{PRODUCT_ID}
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}
products.get	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}	GET https://merchantapi.googleapis.com/products/v1beta/{NAME}
products.list	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products	GET https://merchantapi.googleapis.com/products/v1beta/{PARENT}/products
productstatuses.get	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/productstatuses/{PRODUCT_ID}	GET https://merchantapi.googleapis.com/products/v1beta/{NAME}
productstatuses.list	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/productstatuses	GET https://merchantapi.googleapis.com/products/v1beta/{PARENT}/products

Identyfikatory

Metody	Identyfikator w Content API	Identyfikator w interfejsie Merchant Products API
products.insert	MERCHANT_ID	accounts/{ACCOUNT_ID}
products.delete	MERCHANT_ID, PRODUCT_ID	accounts/{ACCOUNT_ID}/productInputs/{PRODUCT_ID_WITH_TILDES}
products.get	MERCHANT_ID, PRODUCT_ID	accounts/{ACCOUNT_ID}/products/{PRODUCT_ID_WITH_TILDES}
products.list	MERCHANT_ID	accounts/{ACCOUNT_ID}