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

Служба локальной инвентаризации позволяет создавать и обновлять экземпляры ресурса локальной инвентаризации , которые содержат поля, которые могут иметь разные значения для разных физических местоположений магазинов. Каждый экземпляр локального инвентаря является дочерним по отношению к существующему ресурсу продукта и наследует поля данных о продукте от родительского ресурса. Например, у вас может быть продукт, который имеет разную цену и количество в разных магазинах, но имеет одинаковый идентификатор, описание и другие данные о продукте во всех магазинах. Данные о местном ассортименте используются для локальных поверхностей в программах 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 позволяет создавать несколько экземпляров локального инвентаря для одного локального продукта в нескольких магазинах или создавать экземпляры локального инвентаря для нескольких локальных продуктов.