Перенос управления продуктами

Вы можете использовать Merchant API для программной загрузки и управления своими продуктами. Ресурс accounts.products позволяет создать каталог интернет-магазина, то есть список товаров и предложений. Дополнительную информацию о загрузке продуктов и управлении ими с помощью Merchant API см. в разделе Обзор API продуктов Merchant .

Изменения ресурсов

Ресурсы products и productstatuses Content API заменяются ресурсами productInputs и products .

Вы можете использовать ресурс productInputs Merchant API для загрузки информации о вашем продукте. Ресурс product Merchant API можно использовать для получения обработанных продуктов, включая статусы, и его можно получить только через несколько минут после вставки productInputs .

Примечание. Все стандартные методы, такие как вставка, обновление и удаление, доступны только для productInputs , а методы чтения — только для product .

Требования к источнику данных

В Merchant API при загрузке продуктов необходимо указать целевой источник данных. Это может быть либо основной источник данных, либо дополнительный источник данных. Вы можете получить существующие источники данных с помощью dataSources.list или создать новый источник данных с помощью dataSources.create .

Примечание. Источник данных доступен сразу после создания, поэтому вам не нужно ждать какой-либо обработки.

Кроме того, вы можете использовать пользовательский интерфейс Merchant Center для управления источниками данных.

Дополнительную информацию об источниках данных, а также о том, как их создавать и управлять ими, см. в разделе Обзор API источников данных продавцов .

Изменения идентификатора

Merchant API использует имя для идентификации продукта. Название продукта будет соответствовать формату accounts/{account}/products/{product} , где {product} имеет формат channel~language~feedLabel~offerId .

Используемые ресурсы Content API : вместо ~ между каждым значением в идентификаторе: channel:language:feedLabel:offerId .

Все вызовы Merchant API возвращают новый формат с ~ между значениями идентификатора. Мы рекомендуем сохранить новое поле name из ответа и использовать его в будущих вызовах.

Методы

Ниже приведено сравнение методов продуктов в API контента для покупок и API продуктов для торговцев:

API контента для покупок	API торговых продуктов
продукты.custombatch	Недоступно. Вместо этого используйте пакетный запрос .
продукты.вставка	ProductInputs.insert
продукты.обновление	ProductInputs.patch
продукты.обновление	ProductInputs.patch
продукты.удалить	ProductInputs.delete
продукты.получить	продукты.получить
продукты.список	продукты.список
Productstatuses.custombatch	Недоступно. Вместо этого используйте пакетный запрос .
Productstatuses.get	продукты.получить
Productstatuses.list	продукты.список

Примечание. Все методы create , update и delete выполняются только для ресурса productInput . Кроме того, методы productstatuses теперь включены в ресурс продукта.

Запросы

Метод API контента	URL-адрес в Content API для покупок	URL-адрес в 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

Идентификаторы

Методы	Идентификатор в Content API	Идентификатор в 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}