Merchant API позволяет управлять местным (в магазине) и региональным ассортиментом.
Запросы
Используйте следующий формат URL запроса для Merchant Inventories API:
POST https://merchantapi.googleapis.com/inventories/v1/{PARENT}/regionalInventories
POST https://merchantapi.googleapis.com/inventories/v1/{PARENT}/localInventories
{PARENT} будет иметь следующий формат: accounts/{ACCOUNT_ID}/products/ {PRODUCT_ID}.
Ниже приведен пример сравнения запросов рекламы местного ассортимента.
| Показатель | Content API for Shopping | Merchant API |
|---|---|---|
| URL | https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}/localinventory | https://merchantapi.googleapis.com/inventories/v1/{PARENT}/localInventories |
| Идентификаторы | {MERCHANT_ID}/products/{PRODUCT_ID} |
{NAME}
|
Методы
В Merchant API есть два новых метода управления инвентарем:
list– позволяет указывать местный и региональный ассортимент товаров.delete– позволяет удалять данные о местном и региональном ассортименте.
Ниже приведено сравнение доступных методов управления инвентарем.
| Метод | Content API for Shopping | Merchant API |
|---|---|---|
customBatch |
Да | Нет |
insert |
Да | Да |
list |
Нет | Да |
delete |
Нет | Да |
Ресурсы
Вот что изменилось для местного и регионального ассортимента:
| Content API for Shopping | Merchant API | Описание |
|---|---|---|
| Не поддерживаются | name:string
|
Это поле позволяет различать ресурсы LocalInventory и RegionalInventory в product. Content API for Shopping идентифицирует местный ассортимент по атрибутам storeCode и productId, а региональный – по атрибутам regionId и productId.
|
| Не поддерживаются | account:string
|
Добавлено новое поле для идентификации аккаунта Merchant Center, к которому относятся product и LocalInventory.
|
price: {
object (Price)
}
|
price: {
|
Определение сегмента "Price" изменено.
|
salePrice: {
|
salePrice: {
|
Определение сегмента "Price" изменено.
|
salePriceEffectiveDate: string
|
salePriceEffectiveDate: {
|
salePriceEffectiveDate использует новый объект TimePeriod в Merchant Inventories API.
|
kind:string
|
Не поддерживаются | API не поддерживает kind.
|
quantity:string
|
quantity:integer
|
В фиде местного ассортимента значение атрибута quantity должно быть целым числом, а не строкой.
|
| Не поддерживаются | localShippingLabel:string
|
Добавлено новое поле для идентификации аккаунта Merchant Center, к которому относятся product и regionalInventory.
|
"regionId": string
|
"region": string
|
regionID теперь называется region для регионального ассортимента.
|
Поля типа string с заданным набором значений
|
Поля типа enum с заданным набором значений
|
Поля в атрибутах инвентаря с определенным набором значений (например, availability, pickupMethod) теперь имеют тип enum.
|