Перенос партнерства по фидам местного ассортимента

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".

price: {

object (Price)

}

price: {

object (Price)

}

Определение цены изменилось. Подробнее о ценах…
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".

price: {

object (Price)

}

price: {

object (Price)

}

Определение цены изменилось. Подробнее о ценах…
timestamp: string saleTime: string Блокнот "timestamp" переименован. Новое название: "saleTime".
kind: string Не поддерживается kind не поддерживается в API партнерской программы по фидам местного ассортимента.