Questo documento fornisce linee guida sulle best practice. Per saperne di più, consulta i suggerimenti per il rendimento.
Quando utilizzare l'API
Per inviare le richieste in modo programmatico
Sia che tu preferisca automatizzare ogni parte del tuo flusso di lavoro o creare un hook al tuo sistema ERP (Enterprise Resource Planning), l'API Content ti consente di inviare aggiornamenti non appena l'inventario viene modificato.
Per ricevere feedback immediati
Nell'API Content, ricevi una risposta a ogni richiesta all'istante, anziché tramite un riepilogo via email dopo l'elaborazione dei feed di dati. Per le richieste batch di grandi dimensioni è prevista una latenza da 5 a 10 secondi.
Per modificare di frequente i dati di prodotto
Con l'API Content puoi apportare aggiornamenti incrementali al tuo inventario dei prodotti in rapido movimento più volte al giorno, mentre l'invio dell'intero feed di dati ogni volta non è possibile. Se gli aggiornamenti diventano disponibili singolarmente, inviali singolarmente e non attendere che ci siano diversi aggiornamenti in modo da poterli raggruppare in gruppo. Allo stesso modo, se gli aggiornamenti sono disponibili in batch, inviali in batch, non suddividerli in singole richieste.
Per gestire diversi subaccount
I nuovi account Merchant Center sono singoli account che conservano il proprio set di dati di prodotto. Nella maggior parte dei casi questa soluzione funziona bene, ma man mano che il tuo account cresce, potresti scoprire che hai 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 o AMC. La gestione a livello di API di un account AMC può essere effettuata tramite il servizio Account e consente l'aggiunta e la gestione di subaccount a livello di programmazione. Ulteriori informazioni su come ottenere un account AMC sono disponibili qui.
Come utilizzare l'API
Non utilizzare l'API come faresti con i feed di dati
Evita gli aggiornamenti giornalieri dell'intero feed dei prodotti quando utilizzi la risorsa products.
Aggiorna in modo specifico solo i prodotti i cui dati sono stati effettivamente modificati. 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 all'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 destinate al recupero regolare delle
informazioni sui prodotti da parte di tali clienti. Devi avere un'altra origine per le informazioni sui prodotti, ad esempio un database dei prodotti locali, e i prodotti in Merchant Center devono rispecchiare i contenuti di questa origine.
Non utilizzare sia i feed di dati sia l'API Content per inviare gli articoli dei prodotti
Se stai considerando la possibilità di passare all'API per l'invio degli articoli, assicurati di non utilizzare più i feed di dati per inviare gli articoli dei prodotti. Se continui a inviare gli elementi con entrambi i mezzi, potrebbero verificarsi risultati imprevisti.
Esiste un modo per utilizzare in sicurezza il feed di dati e l'API?
Puoi manipolare i feed di dati utilizzando il servizio Datafeed dell'API. Sebbene questo semplificherà molto la gestione dei feed di dati su larga scala, tieni presente che non devi inserire o aggiornare i prodotti utilizzando l'API in concomitanza con i feed, in quanto potrebbero verificarsi risultati imprevisti.
Ecco altri esempi di modi accettabili per utilizzare i feed e l'API congiuntamente:
Esecuzione di richieste di sola lettura (get o list) dall'API: alcuni commercianti vogliono utilizzarla per recuperare informazioni e aggiornamenti di stato sui loro prodotti. Questo è accettabile perché le informazioni sul prodotto vengono aggiornate solo in base ai feed.
Utilizzo dell'API per gestire i tuoi subaccount (Account Service) e/o le impostazioni fiscali e di spedizione a livello di account (Accounttax Service e Shippingsettings Service). Non si tratta di funzioni che i feed di dati possono fornire, quindi non c'è conflitto con l'utilizzo dell'API per la gestione di queste funzioni.
Come faccio a eseguire la migrazione dall'utilizzo dei feed di dati all'utilizzo solo dell'API o viceversa?
Se al momento utilizzi i feed di dati e vuoi passare all'utilizzo solo dell'API per l'aggiornamento dei prodotti, devi ricaricare i dati di prodotto con l'API. Quando utilizzi il servizio di prodotti per aggiornare un determinato prodotto, l'API assume il controllo delle informazioni sul prodotto. L'eliminazione del prodotto dal feed di dati o l'eliminazione del feed di dati stesso non comporta più la rimozione delle informazioni sul prodotto dal tuo account Merchant Center. Se vuoi rimuovere il prodotto dal feed di dati o dal feed di dati stesso, assicurati che non ci siano aggiornamenti dei feed di dati, altrimenti il feed di dati acquisirà nuovamente la proprietà e la rimozione del prodotto dal feed di dati comporterà la rimozione del prodotto.
Se al momento utilizzi solo l'API per le informazioni sui prodotti e vuoi utilizzare i feed di dati come fonte principale di informazioni sui prodotti, puoi semplicemente aggiungere il nuovo feed di dati al tuo account Merchant Center, che acquisirà la proprietà dei prodotti visualizzati. Se vuoi rimuovere prodotti prima della scadenza che sono stati caricati esclusivamente dall'API, devi eliminarli tramite Merchant Center o tramite l'API.
Come posso scegliere più paesi come target di 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 ulteriori paesi nel feed principale dell'API Content in Merchant Center oppure aggiungili tramite il campo shipping nella risorsa products.
Di seguito è riportato un esempio di come modificare le impostazioni del feed principale dell'API Content.
Per ulteriori informazioni, 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 di 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 ulteriori informazioni, consulta la guida per gli sviluppatori per la lingua scelta in Campioni e librerie.
Assicurati di utilizzare gli attributi delle destinazioni per controllare quali prodotti vengono visualizzati nei diversi programmi di acquisto
L'API Content adotta automaticamente le impostazioni predefinite per il feed dell'API Content così come era stato configurato in Merchant Center. Puoi utilizzare gli attributi di 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 tuo feed API è stato attivato in 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 ci sono errori, le impostazioni predefinite del feed in Merchant Center verranno sovrascritte e l'articolo in questione non verrà visualizzato in Acquista su Google (precedentemente noto come Shopping Actions). Al contrario, se
il tuo feed non è stato attivato in 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 maggiori informazioni sugli attributi dei prodotti includedDestinations e
excludedDestinations, consulta il
Centro assistenza.
Assicurati di aggiornare gli articoli prima che scadano
Se un elemento non viene modificato prima della scadenza, 30 giorni dopo l'ultimo aggiornamento o alla data di scadenza specificata, se precedente, aggiorna l'elemento per evitare la disattivazione. Se devi aggiornare molti elementi, perché nessuno di essi è cambiato o non riesci a monitorare la data dell'ultimo aggiornamento, non aggiornare tutti gli elementi contemporaneamente, ma distribuisci il carico in modo uniforme su più giorni.
Non eliminare il feed di Content API, altrimenti i tuoi prodotti potrebbero scomparire
La prima volta che carichi un prodotto con channel:online tramite l'API Content, viene visualizzato un nuovo feed in Merchant Center denominato API Content. La prima volta che carichi un prodotto con channel:local tramite l'API Content, in Merchant Center viene visualizzato un nuovo feed denominato API Content con il sottotitolo Prodotti locali. Assicurati di non eliminare accidentalmente il feed dell'API Content online o locale. A seconda del feed eliminato, i prodotti online o locali che hai aggiunto a Merchant Center tramite l'API Content verranno rimossi.
Raggruppare più richieste allo stesso servizio utilizzando il metodo custombatch
Invece di effettuare molte richieste sequenziali o parallele allo stesso servizio, crea una singola richiesta custombatch che contiene tutte le richieste desiderate. In questo modo, la latenza per le richieste all'endpoint API si verifica solo una volta per la chiamata custombatch invece che per ogni singola richiesta, il che è particolarmente importante se si effettuano richieste sequenziali.
Non inviare più aggiornamenti a un singolo elemento in un unico gruppo
Ciò restituirà risultati imprevisti a causa delle incertezze sulla sequenza degli aggiornamenti e potrebbe causare un errore di conflitto.
Non inviare aggiornamenti per gli elementi che non sono stati modificati
Assicurati di inviare richieste solo per prodotti nuovi, modificati o eliminati, a meno che gli articoli non scadano in altro modo.
Utilizza feed supplementari se i prezzi e/o la disponibilità cambiano rapidamente.
Se hai difficoltà a mantenere aggiornate le informazioni su prezzo, disponibilità o vendita 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 modesta entità, in un determinato periodo puoi apportare molti più aggiornamenti
rispetto agli aggiornamenti di prodotto completi, per mantenere i prezzi e la disponibilità dei tuoi prodotti in linea
con le pagine di destinazione.
Un altro modo per aggiornare il prezzo e la disponibilità dei prodotti consiste nell'utilizzare gli aggiornamenti automatici degli articoli. Questa può essere utilizzata in aggiunta agli aggiornamenti dell'API per evitare errate corrispondenze tra le informazioni in Merchant Center e quelle sulle pagine di destinazione dei prodotti. Tuttavia, tieni presente che questa soluzione è stata pensata per risolvere piccoli problemi relativi all'accuratezza del prezzo e della disponibilità dei prodotti, pertanto gli aggiornamenti automatici degli articoli non sostituiscono l'invio 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 mettere in pratica, in quanto elimina la necessità di richiedere ripetutamente all'utente l'autenticazione, poiché i token di accesso durano solo 60 minuti prima di scadere.