In questa pagina viene spiegato come caricare e gestire i prodotti in modo programmatico. L'API Merchant Products consente di inserire o aggiornare un prodotto in un'origine dati, recuperare un prodotto dal tuo account ed eliminare un prodotto da un'origine dati.
Puoi utilizzare la risorsa products per creare un catalogo per il negozio online, ovvero un elenco dei prodotti disponibili negli annunci Shopping. Puoi utilizzare la risorsa products
dopo aver creato il tuo account Merchant Center e aver deciso di caricare un
insieme iniziale di prodotti tramite l'API.
Sei responsabile della conformità alle norme relative agli annunci Shopping e alle schede senza costi. Gli annunci Shopping si riservano il diritto di applicare queste norme e di rispondere adeguatamente se rileviamo contenuti o comportamenti che violano queste norme.
La risorsa products carica le informazioni sul prodotto nel database di Shopping Merchant Center. Fornisce inoltre diversi metodi che ti consentono di accedere alle informazioni sui prodotti, aggiornarle o eliminarle una alla volta o più metodi alla volta in modalità batch.
La risorsa productInput rappresenta i dati di input che invii per un prodotto. Una risorsa productInput deve avere i seguenti campi:
channel: il canale del prodotto.offerId: l'identificatore univoco del prodotto. Questo valore è lo stesso per l'input di prodotto e il prodotto elaborato.contentLanguage: il codice lingua ISO 639-1 a due lettere del prodotto.feedLabel: l'etichetta del feed del prodotto.
Sebbene i commercianti abbiano la possibilità di caricare i prodotti utilizzando un file chiamato Feed principale, offre diversi vantaggi per la creazione e l'eliminazione dei prodotti utilizzando l'API Merchant. Questi vantaggi includono tempi di risposta più rapidi e la possibilità di aggiornare più prodotti in tempo reale, senza la necessità di gestire più feed supplementari. Potrebbero essere necessarie diverse ore prima che le modifiche ai prodotti effettuate dalle chiamate API vengano visualizzate nel database di Shopping Merchant Center.
Google può aiutarti a mantenere automaticamente alcuni attributi dei tuoi prodotti. Per ulteriori informazioni, consulta la sezione Abilitare i miglioramenti automatici.
Prerequisiti
Se non disponi di un'origine dati, creane una utilizzando l'API Merchant Data sources 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 capire come iniziare a utilizzare l'API Merchant Products.
Carica un input di prodotto nel tuo account
Per caricare un input di prodotto nel tuo account, utilizza il metodo accounts.productInputs.insert. Devi trasmettere
l'identificatore univoco dell'origine dati principale o supplementare per inserire un
prodotto utilizzando l'API Merchant Products.
Recupera 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.
Eliminare l'input di un prodotto dal tuo account
Per eliminare l'input di un prodotto dal tuo account, utilizza il metodo accounts.productInputs.delete. Devi trasmettere l'identificatore univoco dell'origine dati principale o supplementare a cui appartiene il prodotto per eliminare un prodotto utilizzando l'API Merchant Products.
Elenca i prodotti del tuo account
Per elencare i prodotti elaborati nel tuo account, utilizza il metodo accounts.products.list.