Merchant API позволяет передавать в Google данные об ассортименте, магазинах и продажах, чтобы вам было проще управлять ими и продвигать товары.
Новые функции
В Merchant API есть все функции Content API, а также следующие новые возможности:
- Метод получения состояния свойств на уровне компании, связанных с интеграцией партнерства с местными фидами.
- Способ отправки уведомления розничному продавцу.
Подробную информацию об этих методах можно найти в статье API партнерской программы по фидам местного ассортимента.
Запросы
Используйте следующий формат URL запроса для API партнерской программы фидов местного ассортимента:
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert
Подробнее о методе accounts.lfpInventories.insert…
Ниже приведено сравнение запросов на добавление ассортимента в Content API for Shopping и Local Feeds Partnership API.
| Content API | Merchant API | |
| URL |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/inventory
|
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert
|
| Идентификаторы |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}
|
{PARENT} |
Ниже приведено сравнение запросов на добавление продажи в Content API for Shopping и Local Feeds Partnership API.
| Content API | Merchant API | |
| URL | POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/sale |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpSales:insert |
| Идентификаторы | {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} |
Ниже приведено сравнение запросов на добавление магазина в Content API for Shopping и Local Feeds Partnership API.
| Content API | Merchant API | |
| URL | POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpStores:insert |
| Идентификаторы | {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} |
Методы
Вот что изменилось в методах API для магазинов в API партнерской программы по фидам местного ассортимента:
| Метод | URL в Content API for Shopping | URL в Merchant API | Идентификаторы в Content API for Shopping | Идентификаторы в Merchant API | Описание |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{parent=accounts/*}/lfpStores:insert |
/pos {MERCHANT_ID}/{TARGETMERCHANT_ID} |
{PARENT} | parent в формате accounts/{IFP_PARTNER_ACCOUNT_ID} |
delete |
DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
DELETE https://merchantapi.googleapis.com/lfp/v1/{name=accounts/*/lfpStores/*} |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
{NAME} | name в формате accounts/{IFP_PARTNER_ACCOUNT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE} |
get |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
GET https://merchantapi.googleapis.com/lfp/v1/{name=accounts/*/lfpStores/*} |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
{NAME} | name в формате accounts/{IFP_PARTNER_ACCOUNT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE} |
list |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
GET https://merchantapi.googleapis.com/lfp/v1/{parent=accounts/*}/lfpStores |
/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | {PARENT} в формате accounts/{IFP_PARTNER_ACCOUNT_ID} |
Вот что изменилось в методах Inventory API в API партнерской программы по фидам местного ассортимента:
| Метод | URL в Content API for Shopping | URL в Merchant API | Идентификаторы в Content API for Shopping | Идентификаторы в Merchant API | Описание |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | parent в формате accounts/{IFP_PARTNER_ACCOUNT_ID} |
Вот что изменилось в методах API продаж в API партнерской программы по фидам местного ассортимента:
| Метод | URL в Content API for Shopping | URL в Merchant API | Идентификаторы в Content API for Shopping | Идентификаторы в Merchant API | Описание |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpSales:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | {PARENT} имеет формат accounts/{IFP_PARTNER_ACCOUNT_ID} |
Ресурсы
Вот что изменилось для ресурса магазина в API партнерской программы по фидам местного ассортимента. Поля, не указанные здесь, остаются без изменений.
| Content API for Shopping | Merchant API | Описание |
| Не поддерживается | name: string |
Добавлено новое поле, позволяющее различать магазины. |
| Не поддерживается | targetAccount: integer |
Аккаунт Merchant Center, в который нужно добавить сведения об ассортименте. |
targetCountry: string |
regionCode: string |
Блокнот "targetCountry" переименован. Новое название: "regionCode". |
websiteUrl: string |
websiteUri: string |
Блокнот "websiteUrl" переименован. Новое название: "websiteUri". |
kind: string |
Не поддерживается | kind не поддерживается в API партнерской программы по фидам местного ассортимента |
Вот что изменилось в процессе добавления инвентаря. Поля, не указанные здесь, остаются без изменений.
| Content API for Shopping | Merchant API | Описание |
| Не поддерживается | name: string |
Добавлено новое поле для различения разного инвентаря. |
| Не поддерживается | targetAccount: integer |
Аккаунт Merchant Center, в который нужно добавить сведения об ассортименте. |
targetCountry: string |
regionCode: string |
Сервисный аккаунт targetCountry переименован. Новое название: regionCode. Код территории CLDR для страны, в которой продается товар. |
itemId: string |
offerId: string |
Блокнот "itemId" переименован. Новое название: "offerId". |
quantity: string |
quantity: string |
Поле "quantity" теперь необязательное |
| Не поддерживается | availability: string |
Укажите значение в поле "availability". |
|
|
Определение цены изменилось. Подробнее о ценах… |
timestamp: string |
collectionTime: string |
Блокнот "timestamp" переименован. Новое название: "collectionTime". |
kind: string |
Не поддерживается | kind не поддерживается в API партнерской программы по фидам местного ассортимента. |
Вот что изменилось в процессе добавления распродажи. Поля, не указанные здесь, остаются без изменений.
| Content API for Shopping | Merchant API | Описание |
| Не поддерживается | name: string |
Добавлено новое поле для различения разного инвентаря. |
| Не поддерживается | targetAccount:integer |
Аккаунт Merchant Center, в который нужно добавить данные о продажах. |
targetCountry: string |
regionCode: string |
Код территории CLDR для страны, в которой продается товар. |
itemId: string |
offerId: string |
Блокнот "itemId" переименован. Новое название: "offerId". |
|
|
Определение цены изменилось. Подробнее о ценах… |
timestamp: string |
saleTime: string |
Блокнот "timestamp" переименован. Новое название: "saleTime". |
kind: string |
Не поддерживается | kind не поддерживается в API партнерской программы по фидам местного ассортимента. |