Il servizio di inventario locale consente di creare e aggiornare le istanze dei risorsa di inventario locale, che contengono campi che possono avere valori diversi per le diverse sedi fisiche dei negozi. Ogni istanza dell'inventario locale è un'istanza di una risorsa di prodotto esistente, ed eredita i campi dei dati di prodotto risorsa padre. Ad esempio, potresti avere un prodotto con un prezzo e quantità in negozi diversi, ma condivide un ID, una descrizione e altri dati di prodotto in tutti i negozi. I dati dell'inventario locale sono utilizzati per Piattaforme Google locali e gli annunci di inventario locale programmi.
Questa guida spiega cosa ti serve prima di iniziare a utilizzare l'inventario locale servizio, descrive i campi e i metodi disponibili e fornisce un esempio una richiesta di servizio.
Prerequisiti
- Per poter utilizzare il servizio di inventario locale, devi: creare un profilo dell'attività collegare il profilo dell'attività all'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 informazioni sull'utilizzo degli annunci di inventario locale tramite l'API Content, consulta Inizia a utilizzare gli annunci di inventario locale.
Il servizio di inventario locale crea istanze di inventario locale per gli account esistenti prodotti locali Devi prima creare i prodotti locali, utilizzando o il servizio di prodotti API Feed di dati di Merchant Center, per impostando il campo
channel
sulocal
. Puoi quindi utilizzare l'inventario locale per creare istanze di inventario locale per ogni profilo dell'attivitàstorecode
in cui il prodotto viene venduto.
Campi
Ogni istanza dell'inventario locale contiene un insieme di campi associati a un
la sede specifica del negozio tramite il campo storeCode
(che definisci nelle
profilo dell'attività). Solo
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
einstoreProductLocation
Per un elenco completo dei campi relativi all'inventario locale e delle relative descrizioni, consulta la Riferimento localinventory .
Metodi
Il servizio di inventario locale prevede solo due metodi:
localinventory.insert
localinventory.insert
ti consente di creare un'istanza dell'inventario locale per un singolo prodotto locale.
Questo esempio mostra come utilizzare il servizio di inventario locale per creare una vendita in negozio da Dal 24 febbraio 2021 alle 13:00 (GMT-8) fino al 28 febbraio 2021 alle 15:30 (GMT-8). La richiesta aggiorna anche la quantità disponibile per l'inventario locale in esecuzione in un'istanza Compute Engine. Non mi piace feed supplementari per i dati di prodotto non locali, i campi non inclusi nel corpo della vengono sovrascritte 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
prodotto locale in più negozi o crea istanze di inventario locale per
più prodotti locali.