Questo documento fornisce linee guida per le best practice. Per ulteriori informazioni, consulta la sezione Suggerimenti per il rendimento.
Quando utilizzare l'API
Per inviare richieste a livello di programmazione
Che tu preferisca automatizzare ogni parte del tuo flusso di lavoro o creare un hook nel tuo sistema ERP (Enterprise Resource Planning), la Content API ti consente di inviare aggiornamenti non appena l'inventario cambia.
Per ricevere un feedback immediato
Nell'API Content, ricevi una risposta immediata a ogni richiesta, anziché un riepilogo via email dopo l'elaborazione dei feed di dati. Per le richieste di batch di grandi dimensioni è prevista una latenza di 5-10 secondi.
Per modificare spesso i dati di prodotto
Con la Content API puoi apportare aggiornamenti incrementali all'inventario dei prodotti a rapida rotazione più volte al giorno, mentre l'invio dell'intero feed di dati ogni volta non è fattibile. Se gli aggiornamenti diventano disponibili singolarmente, inviali singolarmente, non aspettare che ce ne siano diversi per raggrupparli. Allo stesso modo, se gli aggiornamenti sono disponibili in batch, inviali in batch, non suddividerli in singole richieste.
Per gestire più subaccount
Gli account Merchant Center appena creati sono singoli e contengono un proprio insieme di dati di prodotto. Questo approccio funziona bene nella maggior parte dei casi, ma man mano che il tuo account cresce, potresti aver bisogno di un sistema di gestione più complesso per i tuoi prodotti. Se questo è il tuo caso, valuta la possibilità di utilizzare un account multi-cliente (AMC). La gestione a livello di API di un account Centro clienti può essere eseguita tramite il servizio Accounts e consente l'aggiunta e la gestione programmatica dei subaccount. Ulteriori informazioni su come ottenere un account MCA sono disponibili qui.
Come utilizzare l'API
Non utilizzare l'API come se utilizzassi i feed di dati
Evita gli aggiornamenti giornalieri dell'intero feed dei prodotti quando utilizzi la risorsa products.
Aggiorna invece solo i prodotti i cui dati sono effettivamente cambiati. L'invio dell'intero feed di dati tramite la risorsa products richiede più tempo e risorse sia per Google che per te.
Non utilizzare l'API per recuperare regolarmente le informazioni sui prodotti che hai caricato
Se sei responsabile della gestione delle informazioni sui prodotti in un
determinato account Merchant Center, evita di richiedere informazioni
sui prodotti dall'API Content tramite i metodi
products.get
o
products.list
su base regolare. Per i clienti che caricano informazioni, questi
metodi possono aiutarti a eseguire il debug dei problemi durante la progettazione di soluzioni che
utilizzano l'API Content. Tuttavia, non sono pensati per il recupero regolare di
informazioni sui prodotti da parte di questi client. Devi disporre di un'altra origine per le informazioni sui prodotti, ad esempio un database dei prodotti locali, e i prodotti in Merchant Center devono riflettere i contenuti di questa origine.
Non utilizzare sia i feed di dati sia l'API Content per inviare gli articoli di prodotto
Se stai valutando di passare all'API per l'invio degli articoli, assicurati di non utilizzare più i feed di dati per inviare gli articoli di prodotto. Se continui a inviare elementi su entrambi i mezzi, potrebbero verificarsi risultati imprevisti.
Esiste un modo per utilizzare in modo sicuro API e feed di dati insieme?
Puoi manipolare i feed di dati utilizzando il servizio Datafeed dell'API. Sebbene questo semplifichi notevolmente la gestione dei feed di dati su larga scala, tieni presente che non devi inserire o aggiornare i prodotti utilizzando l'API contemporaneamente ai feed, in quanto potrebbero verificarsi risultati imprevisti.
Ecco altri esempi di modi accettabili per utilizzare feed e API congiuntamente:
Esecuzione di richieste di sola lettura (get o list) dall'API: alcuni commercianti vogliono utilizzare l'API per recuperare informazioni e aggiornamenti di stato sui loro prodotti. Questo è accettabile perché le informazioni sui prodotti vengono aggiornate solo dai feed.
Utilizzo dell'API per gestire i tuoi subaccount (servizio Accounts) e/o le impostazioni di spedizione e fiscali a livello di account (servizio Accounttax e servizio Shippingsettings). Queste non sono funzioni che i feed di dati possono fornire, quindi non c'è alcun conflitto con l'utilizzo dell'API per gestire queste funzioni.
Come faccio a eseguire la migrazione dall'utilizzo dei feed di dati all'utilizzo solo dell'API o viceversa?
Se attualmente utilizzi i feed di dati e vuoi passare all'utilizzo esclusivo dell'API per aggiornare i prodotti, devi ricaricare i dati di prodotto con l'API. Quando utilizzi il servizio products per aggiornare un determinato prodotto, l'API assume il controllo delle informazioni sul prodotto e l'eliminazione del prodotto dal feed di dati o l'eliminazione del feed di dati stesso non rimuoverà più le informazioni sul prodotto dal tuo account Merchant Center. Assicurati che non siano presenti aggiornamenti del feed di dati se vuoi rimuovere il prodotto dal feed di dati o dal feed di dati stesso, altrimenti il feed di dati riacquisterà la proprietà e la rimozione del prodotto dal feed di dati causerà la rimozione del prodotto.
Se al momento utilizzi solo l'API per le informazioni sui prodotti e vuoi utilizzare i feed di dati come origine principale delle informazioni sui prodotti, puoi semplicemente aggiungere il nuovo feed di dati al tuo account Merchant Center e questo assumerà la proprietà dei prodotti elencati. Se vuoi rimuovere prima della scadenza prodotti caricati esclusivamente dall'API, devi eliminarli tramite Merchant Center o l'API.
Come faccio a scegliere come target più paesi con i prodotti utilizzando l'API Content for Shopping?
Per scegliere come target più paesi con annunci e schede senza costi per i prodotti inviati
tramite l'API Content, configura altri paesi nel feed principale dell'API Content
in Merchant Center o aggiungi questi paesi aggiuntivi tramite il campo shipping
nella risorsa products.
Di seguito è riportato un esempio di come modificare le impostazioni del feed principale dell'API Content.
Per saperne di più, consulta: Targeting degli annunci Shopping e delle schede senza costi in più paesi.
Assicurati che le librerie client siano aggiornate
Se utilizzi una libreria client Google per interagire con l'API Content, assicurati di utilizzare il gestore di pacchetti per il linguaggio di programmazione scelto e che la versione della libreria sia aggiornata. Per saperne di più, consulta la guida per gli sviluppatori per la lingua che hai scelto in Esempi e librerie.
Assicurati di utilizzare gli attributi delle destinazioni per controllare quali prodotti vengono visualizzati nei diversi programmi di shopping.
L'API Content adotta automaticamente le impostazioni predefinite per il feed
API Content così come è stato configurato in Merchant Center. Puoi utilizzare gli attributi prodotto
includedDestinations o excludedDestinations per
controllare la partecipazione al programma a livello di prodotto all'interno di un feed o tramite
l'API Content.
Se il feed API è stato attivato per un programma, ad esempio Acquista su Google
(precedentemente noto come Shopping Actions), ma vuoi escludere determinati prodotti,
utilizza l'attributo excludedDestinations e specifica Shopping Actions come
valore. Se non sono presenti errori, le impostazioni predefinite
del feed in Merchant Center verranno sovrascritte e l'articolo specifico non
verrà visualizzato in Acquista su Google (precedentemente noto come Shopping Actions). Al contrario, se
il tuo feed non è stato attivato per un programma, ad esempio Shopping, puoi
includere singoli articoli utilizzando l'attributo includedDestinations e
Shopping_ads come valore e l'articolo verrà visualizzato negli annunci Shopping.
Per ulteriori informazioni sugli attributi di prodotto includedDestinations e excludedDestinations, consulta il Centro assistenza.
Assicurati di aggiornare gli elementi prima della scadenza
Se un articolo non cambia prima della scadenza, 30 giorni dopo l'ultimo aggiornamento o alla data di scadenza specificata, se precedente, aggiorna l'articolo per evitare la sua disattivazione. Se devi aggiornare molti elementi perché nessuno di loro è cambiato o non riesci a monitorare l'ultima volta che sono stati aggiornati, non aggiornarli tutti contemporaneamente, ma distribuisci il carico in modo uniforme su più giorni.
Non eliminare il feed di Content API o i tuoi prodotti potrebbero scomparire
La prima volta che carichi un prodotto con channel:online tramite l'API Content, in Merchant Center viene visualizzato un nuovo feed denominato Content API. La prima
volta che carichi un prodotto con channel:local tramite l'API Content, in Merchant Center viene visualizzato un nuovo
feed intitolato API Content con un sottotitolo
Prodotti locali. Assicurati di non eliminare accidentalmente il feed dell'API Content online o locale. A seconda del feed che elimini, i prodotti online o locali che hai aggiunto a Merchant Center tramite l'API Content verranno rimossi.
Raggruppa più richieste allo stesso servizio utilizzando il metodo custombatch
Anziché effettuare molte richieste sequenziali o parallele allo stesso servizio, effettua una singola richiesta custombatch che contenga tutte le richieste desiderate. In questo modo, la latenza per effettuare richieste all'endpoint API si verifica una sola volta per la chiamata custombatch anziché per ogni singola richiesta, il che è particolarmente importante se effettui richieste sequenziali.
Non inviare più aggiornamenti a un singolo elemento in un unico batch
Ciò darà risultati imprevisti a causa dell'incertezza sulla sequenza di aggiornamenti e potrebbe causare un errore di conflitto.
Non inviare aggiornamenti per gli elementi invariati
Assicurati di inviare richieste solo per elementi di prodotto nuovi, modificati o eliminati, a meno che gli elementi non scadano altrimenti.
Utilizza i feed supplementari se i prezzi e/o la disponibilità cambiano rapidamente
Se hai difficoltà a mantenere aggiornate le informazioni su prezzo, disponibilità o offerta di un prodotto, valuta la possibilità di utilizzare i feed supplementari nella risorsa products per inviare aggiornamenti solo per questi attributi. Poiché gli aggiornamenti dei feed supplementari
sono di piccole dimensioni, puoi apportare molti più aggiornamenti dei feed supplementari in un determinato
periodo rispetto agli aggiornamenti completi dei prodotti, il che ti aiuterà a mantenere i prezzi
e la disponibilità dei tuoi prodotti in linea con le tue pagine di destinazione.
Un altro modo per aggiornare il prezzo e la disponibilità dei prodotti è utilizzare gli aggiornamenti automatici degli articoli. Questi possono essere utilizzati in aggiunta agli aggiornamenti dell'API per evitare mancate corrispondenze tra le informazioni in Merchant Center e quelle sulle pagine di destinazione dei prodotti. Tuttavia, tieni presente che questa funzionalità è progettata per risolvere piccoli problemi relativi alla precisione del prezzo e della disponibilità dei prodotti, pertanto gli aggiornamenti automatici degli articoli non sostituiscono la fornitura delle informazioni corrette tramite l'API.
Quando utilizzare un token di aggiornamento
Il token di aggiornamento viene restituito nell'intestazione HTTP delle richieste di autorizzazione. Contiene molte altre informazioni relative all'autenticazione, ma il token di aggiornamento è spesso l'elemento che gli sviluppatori vogliono ottenere, in quanto elimina la necessità di richiedere ripetutamente l'autenticazione all'utente, dato che i token di accesso durano solo 60 minuti prima di scadere.