Вы можете использовать API Merchant, чтобы делиться данными о своих запасах, магазинах и продажах с Google для лучшей прозрачности и управления.
Новые возможности
В дополнение к функциям Content API, Merchant API предлагает следующие новые функции:
- Метод получения состояния свойств бизнес-уровня, связанных с интеграцией партнерства локальных каналов.
- Метод отправки уведомления продавцу
Подробную информацию об этих методах см. в разделе API партнерства с локальными каналами .
Запросы
Используйте следующий формат URL-адреса запроса для API партнерства с локальными каналами:
POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert
Для получения дополнительной информации см. Метод: accounts.lfpInventories.insert .
Ниже приведен пример сравнения API контента для покупок с API партнерства локальных каналов для запроса на вставку инвентаря:
| API контента | API торговца | |
| URL | POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /pos/ {TARGETMERCHANT_ID} /inventory | POST https://merchantapi.googleapis.com/lfp/v1beta/ {PARENT} /lfpInventories:insert |
| Идентификаторы | {MERCHANT_ID} /pos/ {TARGETMERCHANT_ID} | {PARENT} |
Ниже приведен пример сравнения API контента для покупок с API партнерства локальных каналов для запроса на вставку продажи:
| API контента | API торговца | |
| URL | POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /pos/ {TARGETMERCHANT_ID} /sale | POST https://merchantapi.googleapis.com/lfp/v1beta/ {PARENT} /lfpSales:insert |
| Идентификаторы | {MERCHANT_ID} /pos/ {TARGETMERCHANT_ID} | {PARENT} |
Вот пример сравнения API контента для покупок с API партнерства локальных каналов для запроса на вставку магазина:
| API контента | API торговца | |
| URL | POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /pos/ {TARGETMERCHANT_ID} /store | POST https://merchantapi.googleapis.com/lfp/v1beta/ {PARENT} /lfpStores:insert |
| Идентификаторы | {MERCHANT_ID} /pos/ {TARGETMERCHANT_ID} | {PARENT} |
Методы
Вот что изменилось для методов API магазина в API партнерства локальных каналов:
| Метод | URL в API контента для покупок | URL в API торговца | Идентификаторы в API контента для покупок | Идентификаторы в API торговца | Описание |
insert | POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /pos/ {TARGETMERCHANT_ID} /store | POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent=accounts/*} /lfpStores:insert | {MERCHANT_ID} /pos / {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/v1beta/ {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/v1beta/ {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/v1beta/ {parent=accounts/*} /lfpStores | / {MERCHANT_ID} /pos/ {TARGETMERCHANT_ID} | {PARENT} | {PARENT} имеет формат accounts/ {IFP_PARTNER_ACCOUNT_ID} |
Вот что изменилось для методов API инвентаризации в API партнерства локальных каналов:
| Метод | URL в API контента для покупок | URL в API торговца | Идентификаторы в API контента для покупок | Идентификаторы в API торговца | Описание |
insert | POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /pos/ {TARGETMERCHANT_ID} /store | POST https://merchantapi.googleapis.com/lfp/v1beta/ {PARENT} /lfpInventories:insert | {MERCHANT_ID} /pos/ {TARGETMERCHANT_ID} | {PARENT} | parent имеет формат accounts/ {IFP_PARTNER_ACCOUNT_ID} |
Вот что изменилось для методов API продаж в API партнерства локальных каналов:
| Метод | URL в API контента для покупок | URL в API торговца | Идентификаторы в API контента для покупок | Идентификаторы в API торговца | Описание |
insert | POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /pos/ {TARGETMERCHANT_ID} /store | POST https://merchantapi.googleapis.com/lfp/v1beta/ {PARENT} /lfpSales:insert | {MERCHANT_ID} /pos/ {TARGETMERCHANT_ID} | {PARENT} | {PARENT} имеет формат accounts/ {IFP_PARTNER_ACCOUNT_ID} |
Ресурсы
Вот что изменилось для ресурса магазина в API партнерства локальных каналов. Поля, не включенные сюда, не изменяются.
| API контента для покупок | API торговца | Описание |
| Не поддерживается | name: string | Добавлено новое поле для различения разных магазинов |
| Не поддерживается | targetAccount: integer | Счет Merchant Center для вставки инвентаря для |
targetCountry: string | regionCode: string | targetCountry переименован в regionCode |
websiteUrl: string | websiteUri: string | websiteUrl был переименован в websiteUri |
kind: string | Не поддерживается | kind не поддерживается в API партнерства локальных каналов |
Вот что изменилось для вставки инвентаря. Поля, не включенные сюда, не изменились.
| API контента для покупок | 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 партнерства локальных каналов. |
Вот что изменилось для вставки продажи. Поля, не включенные сюда, не изменились.
| API контента для покупок | 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 партнерства локальных каналов. |