Перенос настроек рекламы местного инвентаря (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 Метод получения всех настроек 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

Ресурсы

Кроме того, для типа 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)		 URI страницы товара в наличии (Universal Resource Identifier) ​​и статус обслуживания для этого regionCode . Укажите хотя бы один из объектов inStock или pickup в API создания, если вы выбрали один из типов MHLSF , но указывайте inStock только если lsfType имеет значение 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 (Заполненная локальная витрина магазина, размещенная продавцом)

В наличии

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 Обязательно. Имя ресурса поставщика LFP.
    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 Обязательно. Контактное лицо для процесса проверки инвентаризации.
    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 Название ресурса счета в фунтах стерлингов
    Формат: 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 local feeds partnership management
    Далее
    Migrate online return policy management