Il presente documento fornisce linee guida per le best practice. Per ulteriori informazioni, consulta i suggerimenti sul rendimento.
Quando utilizzare l'API
a inviare le richieste in modo programmatico
Che tu preferisca automatizzare ogni parte del flusso di lavoro o creare un hook nel tuo sistema ERP (Enterprise Resource Planning), l'API Content ti consente di inviare aggiornamenti non appena l'inventario viene modificato.
Per ricevere un feedback immediato
Nell'API Content ricevi una risposta a ogni richiesta immediatamente, 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 dieci secondi.
Modificare di frequente i dati di prodotto
Con l'API Content puoi apportare aggiornamenti incrementali al tuo inventario dei prodotti in rapido movimento molte volte al giorno, mentre l'invio dell'intero feed di dati ogni volta non è fattibile. Se gli aggiornamenti diventano disponibili singolarmente, inviali singolarmente, senza aspettare che siano disponibili diversi aggiornamenti, in modo da poterli unire in batch. Allo stesso modo, se gli aggiornamenti sono disponibili in batch, inviali in batch, non suddividerli in richieste singole.
Per gestire più subaccount
Gli account Merchant Center appena creati sono singoli account che conservano il proprio set 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 è 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 eseguita 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 invece solo i prodotti i cui dati sono
effettivamente modificati. L'invio dell'intero feed di dati tramite la risorsa products consuma 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 conservazione delle informazioni sui prodotti in un
determinato account Merchant Center, non richiedere regolarmente informazioni sui prodotti
all'API Content tramite i metodi
products.get
o
products.list. Per i client 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 di informazioni sui prodotti da parte dei clienti. Dovresti avere un'altra origine per le informazioni sui prodotti, ad esempio un database dei prodotti locali, e i prodotti in Merchant Center dovrebbero rispecchiare i contenuti di quella origine.
Non utilizzare sia i feed di dati sia l'API Content per inviare gli articoli dei prodotti
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 del prodotto. Se continui a inviare articoli su entrambi i mezzi, potrebbero verificarsi risultati imprevisti.
Esiste un modo per utilizzare in combinazione i feed di dati e l'API in modo sicuro?
Puoi manipolare i feed di dati utilizzando il servizio per feed di dati 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 contemporaneamente ai feed, perché potrebbero verificarsi risultati imprevisti.
Ecco altri esempi di modi accettabili per utilizzare congiuntamente i feed e l'API:
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 (Account Servizio) e/o le impostazioni fiscali e di spedizione a livello di account (Accounttax Service e Shippingsettings Service). Non si tratta di funzioni che Datafeeds può fornire, pertanto non ci sono conflitti con l'uso dell'API per la gestione di queste funzioni.
Come faccio a eseguire la migrazione dai feed di dati all'utilizzo solo dell'API o viceversa?
Se attualmente utilizzi i feed di dati e vuoi passare a utilizzare solo l'API per l'aggiornamento dei prodotti, devi ricaricare i dati di prodotto con l'API. Quando utilizzi il servizio prodotti per aggiornare un determinato prodotto, l'API prende il controllo delle informazioni sul prodotto ed elimina il prodotto dal feed di dati o elimina il feed di dati stesso non rimuove più le informazioni sul prodotto dal tuo account Merchant Center. Assicurati che non siano disponibili 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 riprenderà 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 per le informazioni sui prodotti, puoi semplicemente aggiungere il nuovo feed di dati al tuo account Merchant Center in modo che assumano la proprietà dei prodotti visualizzati. Se vuoi che alcuni prodotti vengano rimossi prima della scadenza e che sono stati 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 oppure aggiungi i 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 di Google per interagire con l'API Content, assicurati di utilizzare il gestore di pacchetti per il linguaggio di programmazione scelto e assicurati che la versione della libreria sia aggiornata. Per ulteriori informazioni, consulta la guida per gli sviluppatori per la lingua scelta in Esempi e librerie.
Assicurati di utilizzare gli attributi "destination" 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 del prodotto includedDestinations o excludedDestinations per controllare la partecipazione al programma a un 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. A condizione che non ci siano 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 ulteriori informazioni sugli attributi dei prodotti includedDestinations e excludedDestinations, consulta il Centro assistenza.
Assicurati di aggiornare gli articoli prima che scadano
Se un elemento non cambia prima della scadenza, 30 giorni dopo l'ultimo aggiornamento o alla data di scadenza specificata se precedente, aggiornalo per evitarne la disattivazione. Se devi aggiornare molti elementi, perché nessuno è cambiato o perché non riesci a monitorare la data dell'ultimo aggiornamento, non aggiornare tutti gli elementi contemporaneamente, ma piuttosto distribuire il carico in modo uniforme su più giorni.
Non eliminare il feed di API Content 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, verrà visualizzato un nuovo feed in Merchant Center denominato API Content con il sottotitolo Prodotti locali. Assicurati di non eliminare accidentalmente il feed online o
locale dell'API Content. 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 in batch allo stesso servizio utilizzando il metodo custombatch
Invece di effettuare molte richieste sequenziali o parallele allo stesso servizio, crea una singola richiesta custombatch che contenga tutte le richieste desiderate. In questo modo, la latenza per l'invio di richieste all'endpoint API avviene solo una volta per la chiamata custombatch anziché per ogni singola richiesta, il che è particolarmente importante se si effettuano richieste sequenziali.
Non inviare più aggiornamenti a un singolo elemento in un unico batch
Ciò comporterà risultati imprevisti a causa dell'incertezza sulla sequenza di aggiornamenti e potrebbe causare un errore di conflitto.
Non inviare aggiornamenti per elementi non modificati
Assicurati di inviare richieste solo per articoli di prodotto nuovi, modificati o eliminati, a meno che gli articoli non scadano.
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 limitati, puoi effettuare in un determinato periodo molti più aggiornamenti del feed supplementare rispetto agli aggiornamenti completi del prodotto, aiutando così a 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 è utilizzare gli aggiornamenti automatici degli articoli. 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 studiata per risolvere piccoli problemi relativi all'accuratezza del prezzo e della disponibilità dei prodotti, pertanto gli aggiornamenti automatici degli articoli non sostituiscono anche l'indicazione 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 ciò che gli sviluppatori vogliono avere a disposizione, in quanto elimina la necessità di chiedere ripetutamente all'utente l'autenticazione poiché i token di accesso durano solo 60 minuti prima della scadenza.