Configurare una libreria client

Ti consigliamo di utilizzare le librerie client delle API di Google per configurare l'API Content for Shopping. Questa guida utilizza le librerie client della Content API per Python come esempio, ma sono disponibili per molti linguaggi di programmazione diffusi e semplificano le attività API comuni come l'autenticazione, l'invio di richieste e l'analisi delle risposte. Per assistenza nella configurazione delle librerie client per altri linguaggi, consulta il file README.md per il linguaggio all'interno del repository googleads/googleads-shopping-samples su GitHub.

Nota: per utilizzare il codice campione in Python, devi installare diverse librerie richieste. Per questo motivo, ti consigliamo di creare un ambiente virtuale Python prima di procedere. Per ulteriori informazioni, consulta Installare pacchetti utilizzando pip e ambienti virtuali.

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

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

   ~/shopping-samples/content/

   Nota: questo percorso, nonché il nome file del 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 del tuo account di servizio, completa i seguenti passaggi:

   1. Vai alla libreria delle API di Google.
   2. Seleziona un progetto nel menu nella parte superiore della pagina. Se non ne hai ancora uno, creane uno facendo clic su Nuovo progetto.
   3. Se non hai ancora abilitato l'API Content for Shopping per questo progetto, cercala nell'elenco delle API di Google e abilitala.
   4. Fai clic sul menu di navigazione (☰) in alto a sinistra, seleziona API e servizi e poi Credenziali.
   5. Per configurare un account di servizio, seleziona Crea credenziali e poi Account di servizio.
   6. Assegna un nome al nuovo account di servizio. Questo nome funge anche da nome utente predefinito per l'ID account di servizio. Registra l'ID del service account, inclusa la parte dopo il carattere "@", per un utilizzo futuro. Fai clic su Crea, quindi segui i passaggi facoltativi per concedere l'accesso al progetto e agli utenti e fai clic Fine.
   7. Verrà visualizzata la pagina Account di servizio, in cui è possibile accedere al nuovo account di servizio.

3. Per ottenere una chiave privata JSON, fai clic sull'account di servizio, quindi sulla scheda Chiavi. Fai clic su Aggiungi chiave > Crea nuova chiave e seleziona JSON come tipo di chiave. Fai clic su Crea per scaricare la chiave privata sul computer. La nuova chiave viene scaricata automaticamente.

4. 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 della API Content scaricata nel passaggio 7.

5. Sposta il file service-account.json nella home directory/shopping-samples/content/.

6. Nella home directory/shopping-samples/content/, crea un file merchant-info.json vuoto.

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

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

8. Aggiungi il nuovo account di servizio come utente al tuo account Merchant Center. Se sei uno sviluppatore di terze parti, dovrai chiedere al tuo cliente di eseguire questo passaggio per te.

   1. Vai al tuo account Merchant Center.
   2. Nelle impostazioni del tuo account Merchant Center, seleziona Persone e accesso.

   3. Fai clic su + Aggiungi persona e utilizza l'ID account di servizio come indirizzo email per il nuovo utente.

      Nota: se non hai preso nota dell'ID account di servizio in precedenza, vai alla pagina Amministrazione degli account di servizio e seleziona il progetto che hai creato.

   4. L'utilizzo del servizio Accounts richiede l'accesso come amministratore, quindi seleziona Amministratore.

   5. Fai clic su Aggiungi utente per salvare le preferenze e tornare all'elenco degli utenti. L'ID account di servizio è elencato con il ruolo utente scelto.

   6. Ripeti la procedura per tutti gli altri account di servizio che vuoi aggiungere.

9. Clona (o scarica ed estrai) il googleads/googleads-shopping-samples repository GitHub in qualsiasi posizione del computer; non deve necessariamente trovarsi nella tua home directory o in ~/shopping-samples/content/.

10. Se hai scaricato ed estratto il repository anziché clonarlo, rinomina la directory estratta in googleads-shopping-samples.

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

    pip install -r requirements.txt
    

Ora la libreria client delle API di Google per Python è configurata e pronta per essere utilizzata con la Content API. Nella sezione successiva, creerai e invierai una richiesta per inserire un nuovo prodotto.