Перенос настроек рекламы местного ассортимента

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

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

Основной компонент	Ресурс
Настройка аккаунта для многоканальных продаж	OmnichannelSetting
Подключение к партнеру по программе "Партнеры по фидам местного ассортимента" для получения данных об ассортименте.	LfpProvider
Связь с аккаунтом профиля компании в Google для получения данных о местных магазинах.	GbpAccount

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

Ниже описано, как изменились запросы и ресурсы.

Запросы

Новый домен	Название метода Content API	Название метода Merchant API
accounts.omnichannelSettings	liasettings.custombatch	Этот метод будет удален. Merchant API поддерживает возможность отправлять несколько запросов одновременно.
	liasettings.get	accounts.omnichannelSettings.list
	liasettings.list	Метод получения всех настроек рекламы местного ассортимента для всех дочерних аккаунтов больше не доступен напрямую. Вместо этого запросите все дочерние аккаунты и используйте 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

Ресурсы

• OmnichannelSetting
  • LsfType
  • InStock
  • Самовывоз
  • LfpLink
  • OnDisplayToOrder
  • Описание
  • InventoryVerification
• LfpProvider
• GbpAccount

Кроме того, сервис по-разному работает с разными значениями PickupType. Подробнее о самовывозе…

OmnichannelSetting

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

LsfType

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

InStock

Shopping Content API		Merchant API
Поле	Тип	Поле	Тип	Описание
(не применимо)	(не применимо)	uri	string	URI целевой страницы товара. Обязательно, если вы выбрали один из типов MHLSF. Обязательно, если задан объект. Для GHLSF оно должно быть пустым, а для MHLSF – нет. Сервис использует его только для проверки показа товаров в наличии. Домен URI должен совпадать с доменом главной страницы продавца.
(не применимо)	(не применимо)	state	enum (ReviewState.State)	Только для вывода. Статус показа товаров в наличии. Доступные значения: ACTIVE FAILED RUNNING ACTION_REQUIRED .

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

Самовывоз

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

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

LfpLink

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

Чтобы узнать версию торгового контента, ознакомьтесь с информацией о LiaPosDataProvider.

OnDisplayToOrder

Shopping Content API		Merchant API
Поле	Тип	Поле	Тип	Описание
shippingCostPolicyUrl	string	uri	string	Обязательно. URI политики "образец для заказа" (ODO).
status	string	state	enum (ReviewState.State)	Только для вывода. Статус URI. Возможные значения: ACTIVE FAILED RUNNING

Версия торгового контента описана в статье LiaOnDisplayToOrderSettings.

Обзор

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

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

InventoryVerification

Shopping Content API		Merchant API
Поле	Тип	Поле	Тип	Описание
status	string	state	enum (InventoryVerification.State)	Только для вывода. Статус проверки ассортимента. Возможные значения: ACTION_REQUIRED INACTIVE RUNNING SUCCEEDED SUSPENDED
inventoryVerificationContactName	string	contact	string	Обязательно. Имя контактного лица для проверки ассортимента
inventoryVerificationContactEmail	string	contactEmail	string	Обязательно. Адрес электронной почты контактного лица для проверки ассортимента.
inventoryVerificationContactStatus	string	contactState	enum (ReviewState.State)	Только для вывода. Статус проверки контакта. Возможные значения: ACTIVE RUNNING

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

LfpProvider

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

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

GbpAccount

Shopping Content API		Merchant API
Field	Type	Поле	Тип	Описание
name	string	name	string	Название ресурса аккаунта профиля компании в Google. Формат: 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.