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

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

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

Основной компонент Ресурс
Настройка учетной записи для обслуживания по всем каналам сети Настройки многоканального взаимодействия
Подключение к партнеру Local Feed Partnership (LFP) для получения данных об инвентаризации. LfpProvider
Подключение к аккаунту Google Business Profile (GBP) для доступа к данным местных магазинов. GbpAccount

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

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

Запросы

Новый домен Название метода API содержимого Название метода API продавца
accounts.omnichannelSettings liasettings.custombatch Этот метод больше не используется. API продавца поддерживает возможность отправки нескольких запросов одновременно .
liasettings.get accounts.omnichannelSettings.list
liasettings.list A method to get all the LIA settings for all sub-accounts is no longer directly available. Instead, query all sub-accounts and use accounts.omnichannelSettings.list to get the omnichannelSettings for the ones of interest.
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

Ресурсы

Кроме того, для типа PickupType работа сервиса отличается. См. Pickup .

Настройки многоканального взаимодействия

API для отображения контента покупок API для продавцов
Поле Тип Поле Тип Описание
(н/д) (н/д) name string Имя ресурса для данной многоканальной настройки. Формат:
Формат: accounts/{account}/omnichannelSettings/{omnichannel_setting}
country string regionCode string Обязательно. Код страны из Common Locale Data Repository (CLDR) (например, "US")
hostedLocalStorefrontActive boolean lsfType enum (LsfType) Обязательно. Тип локального магазина (LSF) для данного regionCode . Возможные значения:
  • GHLSF (локальная витрина магазинов, размещенная на Google)
  • MHLSF_BASIC (Merchant-Hosted Local Storefront Basic, что относится к страницам товаров с информацией о наличии товара в магазине)
  • MHLSF_FULL (Merchant-Hosted Local Storefront Full, что означает «Полная загрузка страниц товаров, доступных в магазине»)
(н/д) (н/д) inStock object
(InStock)		 The in-stock product page URI (Universal Resource Identifier) and serving status for this regionCode . Set at least one of the inStock or pickup objects in the create API if you chose one of the MHLSF types, but only set inStock if the lsfType is GHLSF .
storePickupActive boolean pickup object
(Pickup)		 URI страницы товара Pickup и статус обслуживания для этого regionCode . Укажите хотя бы один из объектов inStock или Pickup в API создания, если вы выбрали один из типов MHLSF , но не указывайте его, если в качестве lsfType указан GHLSF .
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 (см. выше).

LsfType

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

В наличии

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

    • Чтобы ознакомиться с версией контента для покупок, см. 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 Required. The resource name of the LFP provider
    posExternalAccountId string externalAccountId string Обязательно. Идентификатор учетной записи, по которому этот продавец известен поставщику LFP.
    (н/д) (н/д) state enum (ReviewState.State) Только вывод. Состояние LFPLink. Доступные значения:
    • ACTIVE
    • RUNNING

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

    OnDisplayToOrder

    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) Только вывод. Статус процесса проверки запасов. Возможные значения:
  • ТРЕБУЕТСЯ ДЕЙСТВИЕ
  • НЕАКТИВНЫЙ
  • БЕГ
  • УСПЕХ
  • ПРИОСТАНОВЛЕННЫЙ
    • inventoryVerificationContactName string contact string Required. The contact name for the inventory verification process
    inventoryVerificationContactEmail string contactEmail string Обязательно. Адрес электронной почты контактного лица для процесса проверки инвентаризации.
    inventoryVerificationContactStatus string contactState enum (ReviewState.State) Только вывод. Статус проверки контакта. Возможные значения:
  • АКТИВНЫЙ
  • БЕГ

    • Чтобы просмотреть версию содержимого раздела «Покупки», см. разделы LiaCountrySettings и LiaInventorySettings .

    LfpProvider

    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 .

    GbpAccount

    Shopping Content API API для продавцов
    Field Type Поле Тип Описание
    name string name string Название ресурса счета в фунтах стерлингов
    Format: 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 .

    Назад
    Migrate Comparison Shopping Services management