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

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

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

Предпосылки

• Чтобы воспользоваться услугой локального учета запасов, вам необходимо создать бизнес-профиль , связать его с учетной записью 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 позволяет создать локальный экземпляр инвентаря для одного локального продукта.

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