Configurare una libreria client

Scopri l'API Merchant (beta), il successore ufficiale dell'API Content for Shopping.

Ricevi le ultime novità su nuove funzionalità, correzioni di bug e aggiornamenti delle release dell'API Merchant (beta).

Scopri come gestire la tua attività e i tuoi prodotti su Google e come ottenere accesso programmatico a dati, approfondimenti e funzionalità uniche su larga scala. Inizia ora

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 Content per Python come esempio, ma sono disponibili per molti linguaggi di programmazione comuni e semplificano attività comuni dell'API come l'autenticazione, l'invio di richieste e l'analisi delle risposte. Per assistenza nella configurazione delle librerie client per altre lingue, consulta il file README.md relativo al linguaggio nel repo googleads/googleads-shopping-samples su GitHub.

Nota: per utilizzare il codice di esempio 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 i pacchetti utilizzando pip e gli ambienti 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. Nella home directory, crea le seguenti directory:

   ~/shopping-samples/content/

   Nota: questo percorso, nonché il nome del file merchant-info.json creato nel passaggio 5, sono definiti nel file python/shopping/content/common.py all'interno della directory dei sample dell'API Content scaricata nel passaggio 7.

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

   1. Vai alla libreria 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 Google e abilitala.
   4. Nella barra laterale a sinistra, seleziona Credenziali. Per visualizzarla, potrebbe essere necessario fare clic sulla freccia rivolta verso sinistra in alto a sinistra.
   5. Per configurare un account di servizio, seleziona Crea credenziali e poi Account di servizio.
   6. Assegna un nome al nuovo account di servizio. Inoltre, funge da nome utente predefinito per l'ID account di servizio. Registra l'ID account di servizio, inclusa la parte successiva al carattere "@", per utilizzarlo in un secondo momento. Fai clic su Crea, poi segui i passaggi facoltativi per concedere l'accesso al progetto e agli utenti e fai clic su Fine.
   7. Verrà visualizzata la pagina Account di servizio, in cui potrai 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, quindi 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/ nella directory dei sample dell'API Content scaricata nel passaggio 7.

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

6. In 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 tuo conto.

   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 annotato l'ID account di servizio in precedenza, vai alla pagina Amministrazione account di servizio e seleziona il progetto che hai creato.

   4. L'utilizzo del servizio Accounts richiede l'accesso amministrativo, 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 e decomprime) il repository GitHub googleads/googleads-shopping-samples in una posizione qualsiasi del computer. Non deve trovarsi nella home directory o in ~/shopping-samples/content/.

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

11. Per installare le dipendenze richieste per gli esempi, 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 l'API Content. Nella sezione successiva, creerai e invierai una richiesta per inserire un nuovo prodotto.