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 le diverse sedi dei negozi fisici. Ogni istanza di inventario locale è secondaria di una risorsa di prodotto esistente ed eredita i campi dei dati di prodotto dalla risorsa padre. Ad esempio, potresti avere un prodotto che ha prezzi e quantità diversi in negozi diversi, ma che condivide un ID, una descrizione e altri dati di prodotto in tutti i negozi. I dati di inventario locale vengono utilizzati per i programmi Piattaforme Google locali e Annunci di inventario locale.
Questa guida spiega cosa ti serve prima di 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 ulteriori informazioni 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 per i prodotti dell'API Content o i datafeed di Merchant Center, impostando il campo
channel
sulocal
. Puoi quindi utilizzare il servizio di inventario locale per creare istanze di inventario locale per ciascun profilo dell'attivitàstorecode
in cui il prodotto viene venduto.
Campi
Ogni istanza di inventario locale contiene un insieme di campi associati a una specifica sede del negozio tramite il campo storeCode
(che definisci nel profilo della tua attività). Solo storecode
e productId
sono obbligatori per tutte le richieste. Tutti gli altri campi sono facoltativi:
- Obbligatorio per tutte le richieste:
storeCode
,productId
(nell'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 localinventory.
Metodi
Il Servizio di inventario locale prevede soltanto 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 dalle 13:00 del 24 febbraio 2021 alle 13:00 (GMT-8) del 28 febbraio 2021 alle 15:30 (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.