Служба местного инвентаря

Служба локальной инвентаризации позволяет создавать и обновлять экземпляры ресурса локальной инвентаризации , которые содержат поля, которые могут иметь разные значения для разных физических местоположений магазинов. Каждый экземпляр локального инвентаря является дочерним по отношению к существующему ресурсу продукта и наследует поля данных о продукте от родительского ресурса. Например, у вас может быть продукт, который имеет разную цену и количество в разных магазинах, но имеет одинаковый идентификатор, описание и другие данные о продукте во всех магазинах. Данные о местном ассортименте используются для локальных поверхностей в программах Google и Рекламы местного ассортимента .

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

Предварительные условия

  • Чтобы использовать службу местного ассортимента, вам необходимо создать бизнес-профиль , связать его с аккаунтом Merchant Center , подтвердить свой бизнес и настроить коды магазинов в бизнес-профиле .

  • Ваш аккаунт Merchant Center должен быть зарегистрирован в местной программе: либо «Локальные поверхности в Google» , либо «Реклама местного ассортимента» . Дополнительную информацию об использовании рекламы местного ассортимента через Content API см. в разделе Начало работы с рекламой местного ассортимента .

  • Служба локального инвентаря создает экземпляры локального инвентаря для существующих местных продуктов. Сначала необходимо создать локальные продукты, используя службу продуктов Content API или каналы данных Merchant Center, задав для поля channel значение local . Затем вы можете использовать службу локального запаса для создания экземпляров локального запаса для каждого storecode профиля компании, где продается продукт.

Поля

Каждый экземпляр локального запаса содержит набор полей, которые связаны с конкретным местоположением магазина через поле storeCode (которое вы определяете в своем бизнес-профиле). Для всех запросов требуются только storecode и productId . Все остальные поля являются необязательными:

  • Требуется для всех запросов: storeCode , productId (в URL-адресе).
  • Необязательно: quantity , price , salePrice , salePriceEffectiveDate , availability , pickupMethod , pickupSla , instoreProductLocation .

Полный список полей локальной инвентаризации и их описания см. на справочной странице localinventory .

Методы

Служба локальной инвентаризации включает только два метода:

localinventory.insert

localinventory.insert позволяет создать экземпляр локального инвентаря для одного локального продукта.

В этом примере показано, как использовать службу локальных запасов для создания продажи в магазине с 24 февраля 2021 года в 13:00 (GMT-8) до 28 февраля 2021 года в 15:30 (GMT-8). Запрос также обновляет количество, доступное для экземпляра локального запаса. В отличие от дополнительных фидов для нелокальных данных о товарах, поля, не включенные в текст запроса, перезаписываются этим вызовом: 

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId/localinventory

{
  "storeCode": “1235”,
  "salePrice": {
     "value": “100.00”,
     "currency": “USD”
   },
  "salePriceEffectiveDate": “2021-02-24T13:00-0800/2021-02-28T15:30-0800”,
  "quantity": 200,
}

localinventory.custombatch

localinventory.custombatch позволяет создавать несколько экземпляров локального инвентаря для одного локального продукта в нескольких магазинах или создавать экземпляры локального инвентаря для нескольких локальных продуктов.