Configurare una libreria client

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

Nota: per utilizzare il codice campione in Python, devi installare diverse librerie necessarie. Per questo motivo, ti consigliamo di creare un ambiente virtuale Python prima di proseguire. Per saperne di più, consulta la sezione Installare pacchetti utilizzando ambienti pip e virtuali.

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

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

   ~/campioni/shopping/content/

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

2. Per scaricare le credenziali dell'account di servizio:

   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 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/ nella directory di esempio della Content API scaricata nel passaggio 7.

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

5. In 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 repository googleads/googleads-shopping-samples in una qualsiasi posizione sul computer; non deve essere necessariamente nella directory home o in ~/shopping-samples/content/.

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

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

   pip install -r requirements.txt
   

Ora hai configurato la libreria client delle API di Google per Python e pronta all'uso con Content API. Nella sezione successiva, creerai e invierai una richiesta di inserimento di un nuovo prodotto.