Configurare una libreria client

Ti consigliamo di utilizzare Librerie client delle API di Google da impostare l'API Content for Shopping. Questa guida utilizza il client Python Content API ad esempio librerie, ma sono disponibili per molti programmi linguaggi di programmazione e semplificare le attività API più comuni, come l'autenticazione, l'invio di e analizzare le risposte. Per ricevere assistenza per la configurazione delle librerie client per altre lingue, consulta il file README.md per la lingua all'interno googleads/googleads-shopping-samples su GitHub.

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

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

   ~/shopping-samples/content/

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

   1. Vai alla libreria API di Google.
   2. Seleziona un progetto nel menu nella parte superiore della pagina. Se non ne hai uno puoi crearne uno facendo clic su Nuovo progetto.
   3. Se non hai già abilitato l'API Content for Shopping per questa attività, ricercalo nell'elenco delle API di Google e abilitalo.
   4. Nella barra laterale a sinistra, seleziona Credentials (Credenziali). Potresti dover fare clic dalla freccia rivolta verso sinistra in alto a sinistra.
   5. Per configurare un account di servizio, seleziona Crea credenziali, quindi Account di servizio.
   6. Assegna un nome al nuovo account di servizio. È anche il nome utente predefinito l'ID dell'account di servizio. Registrare l'ID account di servizio, inclusa la parte. dopo il carattere "@" per utilizzarlo in seguito. 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 il nuovo servizio all'account di servizio.

3. Per ottenere una chiave privata JSON, fai clic sull'account di servizio, quindi su Chiavi . Fai clic su Aggiungi chiave > Crea nuova chiave, quindi seleziona JSON come il 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.

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

6. In home directory/shopping-samples/content/, crea un valore 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 se sei uno sviluppatore di terze parti, dovrai chiedere al cliente di eseguire questo passaggio per te.

   1. Accedi al tuo account Merchant Center.
   2. Nelle impostazioni del tuo account Merchant Center, seleziona Persone e l'accesso alle app.

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

   4. L'utilizzo del servizio Accounts richiede l'accesso amministrativo, quindi seleziona Amministrazione.

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

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

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

10. Se hai scaricato e decompresso il repository, anziché clonarlo, rinomina il repository decompressa 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
    

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.