Il servizio di inventario locale consente di creare e aggiornare istanze della risorsa di inventario locale, che contengono campi che possono avere valori diversi per diverse sedi fisiche dei negozi. Ogni istanza di inventario locale è un'istanza secondaria di una risorsa di prodotto esistente ed eredita i campi dei dati di prodotto dalla risorsa padre. Ad esempio, potresti avere un prodotto con prezzi e quantità diversi in negozi diversi, ma che condividono un ID, una descrizione e altri dati di prodotto in tutti i negozi. I dati dell'inventario locale vengono utilizzati per i programmi Piattaforme Google locali e Annunci di inventario locale.
Questa guida spiega cosa occorre per poter iniziare a utilizzare il servizio di inventario locale, descrive i campi e i metodi disponibili e fornisce un esempio di richiesta di servizio.
Prerequisiti
- Per utilizzare il servizio di inventario locale, devi creare un profilo dell'attività, collegare il profilo dell'attività al tuo account Merchant Center, verificare la tua attività e configurare i codici negozio del profilo dell'attività.
Il tuo account Merchant Center deve essere registrato a un programma locale: Piattaforme Google locali o Annunci di inventario locale. Per scoprire di più sull'utilizzo degli annunci di inventario locale tramite l'API Content, consulta Iniziare a utilizzare gli annunci di inventario locale.
Il servizio di inventario locale crea istanze di inventario locale per i prodotti locali esistenti. Per prima cosa, devi creare i prodotti locali utilizzando il servizio prodotti dell'API Content o i feed di dati di Merchant Center, impostando il campo
channel
sulocal
. Potrai quindi utilizzare il servizio di inventario locale per creare istanze di inventario locale per ognistorecode
profilo dell'attività in cui il prodotto viene venduto.
Campi
Ogni istanza dell'inventario locale contiene un insieme di campi associati a una sede specifica del negozio tramite il campo storeCode
(che definisci nel profilo dell'attività). Solo i campi
storecode
e
productId
sono obbligatori per tutte le richieste. Tutti gli altri campi sono facoltativi:
- Obbligatorio per tutte le richieste:
storeCode
,productId
(in URL) - Facoltativo:
quantity
,price
,salePrice
,salePriceEffectiveDate
,availability
,pickupMethod
,pickupSla
,instoreProductLocation
Per un elenco completo dei campi dell'inventario locale e delle relative descrizioni, consulta la pagina di riferimento di localinventory.
Metodi
Il servizio di inventario locale prevede solo due metodi:
localinventory.insert
localinventory.insert
ti consente di creare un'istanza di inventario locale per un singolo prodotto locale.
Questo esempio mostra come utilizzare il servizio di inventario locale per creare una promozione in negozio dal 24 febbraio 2021 alle 13:00 (GMT-8) fino alle 15:30 del 28 febbraio 2021 (GMT-8). La richiesta aggiorna anche la quantità disponibile per l'istanza di inventario locale. A differenza dei feed supplementari per i dati di prodotto non locali, i campi che non sono inclusi nel corpo della richiesta vengono sovrascritti da questa chiamata:
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
consente di creare più istanze di inventario locale per un singolo prodotto locale in più negozi oppure di creare istanze di inventario locale per più prodotti locali.