Вы можете использовать Merchant API для программной загрузки и управления своими продуктами. Ресурс accounts.products позволяет создать каталог интернет-магазина, то есть список товаров и предложений. Дополнительную информацию о загрузке продуктов и управлении ими с помощью Merchant API см. в разделе Обзор API продуктов Merchant .
Изменения ресурсов
Ресурсы products и productstatuses Content API заменяются ресурсами productInputs и products .
Вы можете использовать ресурс productInputs Merchant API для загрузки информации о вашем продукте. Ресурс product Merchant API можно использовать для получения обработанных продуктов, включая их статусы.
Требования к источнику данных
В 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.delete |
| продукты.получить | продукты.получить |
| продукты.список | продукты.список |
| Productstatuses.custombatch | Нет в наличии |
| Productstatuses.get | продукты.получить |
| Productstatuses.list | продукты.список |
Запросы
| Метод API контента | URL-адрес в Content API для покупок | URL-адрес в API торговых продуктов | Идентификатор в Content API | Идентификатор в 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} | Нет в наличии | ||
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} |