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