Scopri l'API Merchant, il successore ufficiale dell'API Content for Shopping.

Ricevi le ultime novità su nuove funzionalità, correzioni di bug e aggiornamenti dell'API Merchant.

Inizia a utilizzare l'API Merchant e accedi a dati, approfondimenti e funzionalità uniche su larga scala.

Nota: l'API Content for Shopping verrà ritirata il 18 agosto 2026.

Questa pagina è stata tradotta dall'API Cloud Translation.

Servizio di inventario locale

Il servizio di inventario locale ti consente di creare e aggiornare istanze della risorsa inventario locale, che contengono campi che possono avere valori diversi per diverse sedi fisiche del negozio. Ogni istanza di inventario locale è un elemento secondario di una risorsa prodotto esistente e eredita i campi di dati di prodotto dalla risorsa principale. Ad esempio, potresti avere un prodotto con un prezzo e una quantità diversi in negozi diversi, ma che condivide 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 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 della tua attività.
Il tuo account Merchant Center deve essere registrato a un programma locale: piattaforme locali su Google o annunci di inventario locale. Per ulteriori informazioni sull'utilizzo degli annunci di inventario locale tramite l'API Content, consulta Inizia a utilizzare gli annunci di inventario locale.

Nota: se il tuo account Merchant Center non è registrato a un programma locale, l'impostazione del campo channel di un prodotto su local, tramite il metodo Products.insert, genera l'errore: "channel Canale non valido: locale".
Il servizio di inventario locale crea istanze di inventario locale per i prodotti locali esistenti. Devi prima creare i prodotti locali utilizzando il servizio products dell'API Content o i feed di dati di Merchant Center impostando il campo channel su local. Puoi quindi utilizzare il servizio di inventario locale per creare istanze di inventario locale per ogni profilo dell'attività storecode in cui viene venduto il prodotto.

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 tuo profilo dell'attività). Solo storecode e productId sono obbligatori per tutte le richieste. Tutti gli altri campi sono facoltativi:

Obbligatori 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 include 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 vendita in negozio dal 24 febbraio 2021 alle 13:00 (GMT-8) al 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 non 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 ti consente di creare più istanze di inventario locale per un singolo prodotto locale in più negozi oppure creare istanze di inventario locale per più prodotti locali.