Questa pagina spiega come caricare e gestire i prodotti in modo programmatico. Con l'API Merchant Products, puoi inserire o aggiornare un prodotto in un'origine data, recuperare un prodotto dal tuo account ed eliminare un prodotto da un'origine data.
L'API Merchant Products contiene due risorse.
productInputsrappresenta le parti di input dei tuoi prodotti.productsrappresenta i prodotti elaborati creati dalle parti di input.
productInputs può essere principale e supplementare, a seconda che venga caricato in un'origine dati principale o in un'origine dati supplementare.
Ogni product verrà costruito da un singolo productInput principale e da un qualsiasi numero di productInputs supplementari.
Puoi utilizzare l'API Merchant Products per creare cataloghi di negozi online o locali, ovvero prodotti che possono essere visualizzati su più destinazioni di acquisto.
Puoi utilizzare la risorsa productInputs dopo aver creato il tuo account Merchant Center, aver configurato la tua prima origine dati e aver caricato un primo insieme di prodotti tramite l'API.
Sebbene i commercianti abbiano la possibilità di caricare i prodotti utilizzando un file chiamato PrimaryProductDataSource, esistono diversi vantaggi nella creazione e nell'eliminazione dei prodotti tramite l'API Merchant. Questi vantaggi includono tempi di risposta più rapidi e la possibilità di aggiornare i prodotti in tempo reale, senza dover gestire file di grandi dimensioni. Potrebbero essere necessarie fino a diverse ore prima che le modifiche ai prodotti apportate tramite le chiamate API vengano visualizzate nel database Shopping.
Prerequisiti
Se non hai un'origine dati, creane una utilizzando l'API Merchant DataSources o Merchant Center.
Se hai già un'origine dati creata utilizzando l'interfaccia utente di Merchant Center o l'API, puoi utilizzare l'API Merchant Products per aggiungere i tuoi prodotti. Se utilizzi l'API Content for Shopping per aggiungere prodotti, consulta la guida alla migrazione per scoprire come iniziare a utilizzare l'API Merchant Products.
Sei responsabile della conformità alle norme relative agli annunci Shopping e alle schede senza costi. Google si riserva il diritto di applicare queste norme e di rispondere in modo appropriato se vengono rilevati contenuti o comportamenti che le violano.
Risorse
La risorsa products ti consente di recuperare le informazioni sui prodotti dal database Shopping.
La risorsa
productInput rappresenta i dati di input che invii per un prodotto. Fornisce inoltre metodi che ti consentono di aggiornare o eliminare le informazioni sui prodotti una alla volta o più alla volta in modalità batch. Una risorsa productInput deve avere i seguenti campi:
channel: il canale del prodotto.offerId: l'identificatore univoco del prodotto.contentLanguage: il codice lingua di due lettere ISO 639-1 per il prodotto.feedLabel: l'etichetta del feed per il prodotto.
Caricare un input del prodotto nel tuo account
Per caricare un input del prodotto nel tuo account, utilizza il metodo
accounts.productInputs.insert. Devi passare l'identificatore univoco dell'origine dati principale o supplementare.
Recuperare un prodotto elaborato dal tuo account
Per recuperare un prodotto elaborato dal tuo account, utilizza il metodo
accounts.products.get. Potrebbero essere necessari diversi minuti prima che il prodotto elaborato venga visualizzato dopo l'inserimento.
Puoi ottenere il nome della risorsa del prodotto elaborato dal campo product
nella
risposta di accounts.productInputs.insert
Eliminare un input del prodotto dal tuo account
Per eliminare un input del prodotto dal tuo account, utilizza il metodo
accounts.productInputs.delete. Per eliminare un prodotto utilizzando l'API Merchant Products, devi passare l'identificatore univoco dell'origine dati principale o supplementare a cui appartiene il prodotto.
Elenca i prodotti dal tuo account
Per elencare i prodotti elaborati nel tuo account, utilizza il accounts.products.list
metodo.