Configurare una libreria client

Ti contattiamo per presentarti la versione beta dell'API Merchant. È la nuova versione dell'API Content e quella futura.

Ti consigliamo di utilizzare le librerie client delle API di Google per configurare l'API Content for Shopping. Questa guida utilizza le librerie client dell'API Python Content, ma sono disponibili per molti linguaggi di programmazione più diffusi e semplificano le attività API più comuni, come l'autenticazione, l'invio di richieste e l'analisi delle risposte. Per assistenza sulla configurazione delle librerie client per altre lingue, consulta la pagina README.md per la lingua all'interno del repository googleads/googleads-shopping-samples su GitHub.

Nota: devi installare diverse librerie necessarie per utilizzare il codice di esempio in Python. Per questo motivo, consigliamo di creare un ambiente virtuale Python prima di procedere. Per maggiori informazioni, consulta Installazione di pacchetti utilizzando ambienti pip e virtuali.

Per configurare la libreria client dell'API di Google per Python, completa i seguenti passaggi:

1. Crea una directory per i file di configurazione e autenticazione della libreria client. All'interno della directory home, crea le seguenti directory:

   ~/shopping-samples/content/

   Nota: questo percorso, così come il nome del file per il file merchant-info.json creato nel passaggio 5, sono definiti nel file python/shopping/content/common.py all'interno della directory degli esempi dell'API Content scaricata nel passaggio 7.

2. Per scaricare le credenziali dell'account di servizio, completa i seguenti passaggi:

   1. In Merchant Center, nel menu Impostazioni, seleziona Content API.
   2. Fai clic su Autenticazione.
   3. Fai clic su [+] CREA CHIAVE API.
   4. Se richiesto, leggi e accetta i contratti con i Termini di servizio.

   La nuova chiave viene scaricata automaticamente.

3. Rinomina il file delle credenziali scaricato in service-account.json.

   Nota: questo nome file è definito nel file _constants.py, che si trova in python/shopping/content/ all'interno della directory degli esempi dell'API Content scaricata nel passaggio 7.

4. Sposta il file service-account.json in home directory/shopping-samples/content/.

5. Nel tuo home directory/shopping-samples/content/, crea un file merchant-info.json vuoto.

6. In merchant-info.json, aggiungi il seguente testo:

   {
   "merchantId": your Merchant Center merchant ID,
   "accountSampleUser": "the email address associated with your Merchant Center account"
   }
   

7. Clona (o scarica e decomprimi) il googleads/googleads-shopping-samples repository GitHub in una posizione qualsiasi sul tuo computer; non deve essere necessariamente nella directory home o in ~/shopping-samples/content/.

8. Se hai scaricato e decompresso il repository, anziché clonarlo, rinomina la directory decompressa in googleads-shopping-samples.

9. Per installare le dipendenze di esempio richieste, in una finestra del terminale accedi a googleads-shopping-samples/python/ ed esegui:

   pip install -r requirements.txt
   

La libreria client dell'API di Google per Python è ora configurata e pronta per essere utilizzata con l'API Content. Nella sezione successiva, creerai e invierai una richiesta di inserimento di un nuovo prodotto.