Партнерство по переносу местных каналов

Вы можете использовать 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 партнерства с местными фидами.