Вы можете использовать Merchant API, чтобы делиться своими запасами, магазинами и данными о продажах с Google для лучшей видимости и управления.
Новые возможности
В дополнение к функциям Content API Merchant API предлагает следующие новые функции:
- Метод получения состояния свойств на уровне продавца, связанных с интеграцией партнерства с местными фидами.
- Способ отправки уведомления продавцу
Подробную информацию об этих методах см. в разделе API партнерства с локальными фидами .
Запросы
Используйте следующий формат URL-адреса запроса для API партнерства с местными фидами:
POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert
Дополнительные сведения см. в разделе Метод: account.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-адрес в Content API для покупок | URL-адрес в Merchant API | Идентификаторы в Content API для покупок | Идентификаторы в Merchant 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-адрес в Content API для покупок | URL-адрес в Merchant API | Идентификаторы в Content API для покупок | Идентификаторы в Merchant 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-адрес в Content API для покупок | URL-адрес в Merchant API | Идентификаторы в Content API для покупок | Идентификаторы в Merchant 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 | Торговый счет для добавления инвентаря |
targetCountry: string | regionCode: string | targetCountry переименован в regionCode |
websiteUrl: string | websiteUri: string | websiteUrl переименован в URL websiteUri |
kind: string | Не поддерживается | kind не поддерживается в API партнерства с местными фидами |
Вот что изменилось при вставке инвентаря. Поля, не включенные сюда, остаются неизменными.
| 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 | Не поддерживается | kind не поддерживается в API партнерства с местными фидами. |
Вот что изменилось при вставке продажи. Поля, не включенные сюда, остаются неизменными.
| API контента для покупок | Торговый API | Описание |
| Не поддерживается | name: string | Добавлено новое поле для различения разных запасов. |
| Не поддерживается | targetAccount:integer | Торговый счет, для которого нужно вставить продажи |
targetCountry: string | regionCode: string | Код территории CLDR для страны, в которой продается продукт. |
itemId: string | offerId: string | itemId переименован в offerId |
| цена: { объект (Цена) } | Определение цены изменилось. Дополнительную информацию см. в разделе Цена . |
timestamp: string | saleTime: string | timestamp переименована в saleTime |
kind: string | Не поддерживается | kind не поддерживается в API партнерства с местными фидами. |