Перенос настроек рекламы местного ассортимента (LIA), Перенос настроек рекламы местного ассортимента (LIA), Перенос настроек рекламы местного ассортимента (LIA)

Если вы использовали настройки рекламы местного ассортимента в API торгового контента, в Merchant API есть несколько важных изменений.

Настройки LIA теперь принадлежат одному из трех основных компонентов, каждый из которых имеет связанный ресурс.

Основной компонент	Ресурс
Конфигурация учетной записи для многоканального обслуживания	Настройка многоканального доступа
Подключение к партнеру Local Feed Partnership (LFP) для получения данных о запасах	Лфппровайдер
Подключение к аккаунту профиля компании Google (GBP) для получения данных о местных магазинах	GbpСчет

Кроме того, в настройках LIA для каждой учетной записи использовался один ресурс, содержащий список настроек для каждой национальной организации. С помощью OmnichannelSettings вы можете связать с учетной записью несколько ресурсов. Каждый ресурс представляет настройки для определенного национального объекта.

Вот как изменились запросы и ресурсы.

Запросы

Новый домен	Имя метода Content API	Название метода Merchant API
accounts.omnichannelSettings	liasettings.custombatch	Этот метод уходит. Merchant API поддерживает возможность отправки нескольких запросов одновременно .
	liasettings.get	accounts.omnichannelSettings.list
	liasettings.list	Способ получения всех настроек LIA для всех субаккаунтов больше недоступен напрямую. Вместо этого запросите все дочерние учетные записи и используйте accounts.omnichannelSettings.list , чтобы получить настройки omnichannelSettings для тех, которые вас интересуют.
	liasettings.update	accounts.omnichannelSettings.create, accounts.omnichannelSettings.update
	liasettings.requestinventoryverification	accounts.omnichannelSettings.requestInventoryVerification
	liasettings.setinventoryverificationcontact	Этот метод уходит. Вместо этого accounts.omnichannelSettings.create accounts.omnichannelSettings.update с обновленной маской.
	liasettings.setomnichannelexperience	Этот метод уходит. Вместо этого accounts.omnichannelSettings.create accounts.omnichannelSettings.update с обновленной маской.
accounts.omnichannelSettings.lfpProvider	liasettings.listposdataproviders	accounts.omnichannelSettings.lfpProviders.findLfpProviders
	liasettings.setposdataprovider	accounts.omnichannelSettings.lfpProviders.linkLfpProvider
accounts.gbpAccount	liasettings.getaccessiblegmbaccounts	accounts.gbpAccount.list
	liasettings.requestgmbaccess	accounts.gbpAccount.linkGbpAccount

Ресурсы

• Настройка многоканального доступа
  • ЛсфТип
  • В наличии
  • Подобрать
  • Лфплинк
  • Ондисплетоордер
  • О
  • Проверка инвентаря
• Лфппровайдер
• GbpСчет

Кроме того, для PickupType служба ведет себя по-разному. См. Самовывоз .

Настройка многоканального доступа

API торгового контента		Торговый API
Поле	Тип	Поле	Тип	Описание
(н/д)	(н/д)	name	string	Имя ресурса этого многоканального параметра. Формат: Формат: accounts/{account}/omnichannelSettings/{omnichannel_setting}
country	string	regionCode	string	Необходимый. Код страны Common Locale Data Repository (CLDR) (например, «США»)
hostedLocalStorefrontActive	boolean	lsfType	enum (LsfType)	Необходимый. Тип Local Store Front (LSF) для этого regionCode . Возможные значения включают в себя GHLSF (витрина локального магазина, размещенная в Google) MHLSF_BASIC (базовая витрина локального магазина, размещаемая продавцом, которая относится к страницам продуктов, доступных в магазине) MHLSF_FULL (Полная витрина локального магазина, размещенная продавцом, что относится к страницам продуктов, которые доступны в магазине)
(н/д)	(н/д)	inStock	object (InStock)	URI страницы товара в наличии (универсальный идентификатор ресурса) и статус обслуживания для этого regionCode . Установите хотя бы один из объектов inStock или pickup в API создания, если вы выбрали один из типов MHLSF , но установите inStock только в том случае, если lsfType равен GHLSF .
storePickupActive	boolean	pickup	object (Pickup)	URI страницы продукта Самовывоза и статус обслуживания для этого regionCode . Установите хотя бы один из объектов inStock или Pickup в API создания, если вы выбрали один из типов MHLSF , но не устанавливайте его, если GHLSF установлен как lsfType .
posDataProvider	object (LiaPosDataProvider)	lfpLink	object (LfpLink)	Только вывод. Установленная связь с провайдером LFP
onDisplayToOrder	object (LiaOnDisplayToOrderSettings)	odo	object (OnDisplayToOrder)	URI политики «на дисплее для заказа» (ODO) и статус для этого regionCode
about	object (LiaAboutPageSettings)	about	object (About)	URI страницы «О нас» и статус для этого regionCode
inventory	object (LiaInventorySettings)	inventoryVerification	object (InventoryVerification)	Статус процесса проверки запасов и контактная информация для этого regionCode
omnichannelExperience	object (LiaOmnichannelExperience)	(н/д)	(н/д)	Используйте lsfType и pickup (выше).

ЛсфТип

API торгового контента		Торговый API
Поле	Тип	Поле	Тип	Описание
lsfType	string	lsfType	enum (LsfType)	Тип «Витрина местного магазина» (LSF). Возможные значения: GHLSF (витрина местного магазина, размещенная на Google) MHLSF_BASIC (базовая витрина локального магазина, размещенная у продавца) MHLSF_FULL (витрина местного магазина, размещенного у продавца, заполнена)

В наличии

API торгового контента		Торговый API
Поле	Тип	Поле	Тип	Описание
(н/д)	(н/д)	uri	string	URI целевой страницы продукта. Требуется, если вы выбрали один из типов MHLSF . Требуется, если объект установлен. Для GHLSF оно должно быть пустым, а для MHLSF — непустым. Сервис использует его только для проверки наличия товаров на складе. Этот домен URI должен соответствовать домашней странице продавца.
(н/д)	(н/д)	state	enum (ReviewState.State)	Только вывод. Статус порции в наличии. Доступные значения: АКТИВНЫЙ НЕУСПЕШНЫЙ БЕГ ACTION_REQUIRED

Чтобы просмотреть версию торгового контента, см. LiaCountrySettings и LiaOmnichannelExperience .

Подобрать

API торгового контента		Торговый API
Поле	Тип	Поле	Тип	Описание
(н/д)	(н/д)	uri	string	URI страницы самовывоза. Требуется, если объект установлен. API использует его только для проверки обслуживания самовывоза. Этот домен URI должен соответствовать домашней странице продавца.
LiaInventorySettings.status	string	state	enum (ReviewState.State)	Только вывод. Статус подачи самовывоза. Доступные значения: ACTIVE FAILED RUNNING

Чтобы просмотреть версию торгового контента, см. LiaCountrySettings и LiaOmnichannelExperience .

Лфплинк

API торгового контента		Торговый API
Поле	Тип	Поле	Тип	Описание
posDataProviderId	string	lfpProvider	string	Необходимый. Имя ресурса поставщика LFP
posExternalAccountId	string	externalAccountId	string	Необходимый. Идентификатор учетной записи, под которым этот продавец известен поставщику LFP.
(н/д)	(н/д)	state	enum (ReviewState.State)	Только вывод. Статус LfpLink. Доступные значения: ACTIVE RUNNING

Чтобы просмотреть версию торгового контента, см. LiaPosDataProvider .

Ондисплетоордер

API торгового контента		Торговый API
Поле	Тип	Поле	Тип	Описание
shippingCostPolicyUrl	string	uri	string	Необходимый. URI политики «на дисплее для заказа» (ODO).
status	string	state	enum (ReviewState.State)	Только вывод. Статус URI. Возможные значения: АКТИВНЫЙ НЕУСПЕШНЫЙ БЕГ

Чтобы просмотреть версию торгового контента, см. LiaOnDisplayToOrderSettings .

О

API торгового контента		Торговый API
Поле	Тип	Поле	Тип	Описание
url	string	uri	string	Необходимый. URI страницы «О нас»
status	string	state	enum (ReviewState.State)	Только вывод. Статус URI. Возможные значения: ACTIVE FAILED RUNNING

Чтобы просмотреть версию торгового контента, см. LiaAboutPageSettings .

Проверка инвентаря

API торгового контента		Торговый API
Поле	Тип	Поле	Тип	Описание
status	string	state	enum (InventoryVerification.State)	Только вывод. Статус процесса проверки инвентаря. Возможные значения: ACTION_REQUIRED НЕАКТИВНО БЕГ УСПЕШНО ПРИОСТАНОВЛЕННЫЙ
inventoryVerificationContactName	string	contact	string	Необходимый. Контактное имя для процесса проверки запасов
inventoryVerificationContactEmail	string	contactEmail	string	Необходимый. Электронная почта контактного лица для процесса проверки запасов
inventoryVerificationContactStatus	string	contactState	enum (ReviewState.State)	Только вывод. Статус проверки контакта. Возможные значения: АКТИВНЫЙ БЕГ

Чтобы просмотреть версию торгового контента, см. LiaCountrySettings и LiaInventorySettings .

Лфппровайдер

API торгового контента		Торговый API
Поле	Тип	Поле	Тип	Описание
fullName	string	name	string	Имя ресурса поставщика LFP. Формат: accounts/{account}/omnichannelSettings/{omnichannel_setting}/lfpProviders/{lfp_provider}
(н/д)	(н/д)	regionCode	string	Необходимый. CLDR-код страны
providerId	string	(н/д)	(н/д)	Это поле уходит.
displayName	string	displayName	string	Отображаемое имя поставщика LFP

Чтобы просмотреть версию торгового контента, см. PosDataProvidersPosDataProvider .

GbpСчет

Shopping Content API		Торговый API
Field	Type	Поле	Тип	Описание
name	string	name	string	Имя ресурса учетной записи GBP Формат: accounts/{account}/gbpAccount/{gbp_account}
(н/д)	(н/д)	gbpAccountId	string	Идентификатор бизнес-профиля
type	string	type	enum (GbpAccount.Type)	Тип бизнес-профиля. Доступные значения: USER (личный кабинет) BUSINESS_ACCOUNT (бизнес-аккаунт)
email	string	gbpAccountName	string	Название бизнес-профиля: Для личных аккаунтов это адрес электронной почты владельца. Для бизнес-аккаунтов это имя бизнес-аккаунта.
listingCount	string	listingCount	int64	Количество объявлений, связанных с этим аккаунтом

Чтобы просмотреть версию торгового контента, см. GmbAccountsGmbAccount .