Consigliamo di utilizzare la libreria client con Apache Maven (o Gradle).
Creare un nuovo progetto Maven/Gradle
Crea un nuovo progetto Maven/Gradle nell'IDE che preferisci. I nostri elementi vengono pubblicati nel repository Maven Central.
La dipendenza Maven è:
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads</artifactId>
<version>36.0.0</version>
</dependency>
La dipendenza Gradle è:
implementation 'com.google.api-ads:google-ads:36.0.0'
Puoi anche eseguire il build dal codice sorgente. Ai fini di questa guida, si presume che tu abbia configurato un progetto con le dipendenze richieste.
Ottenere le credenziali per l'autenticazione con l'API
Per accedere all'API Google Ads sono necessarie le credenziali OAuth e un token sviluppatore dell'API Google Ads. Questa sezione spiega che cosa sono, come vengono utilizzati e come vengono ottenuti.
Token sviluppatore (per l'accesso all'API)
Il token sviluppatore è collegato a un account amministratore ed è disponibile nell'interfaccia web di Google Ads.
Sebbene il token sviluppatore sia collegato a un account amministratore, non fornisce accesso a quell'account. Il token sviluppatore concede invece l'accesso all'API in generale e l'accesso a livello di account viene configurato tramite OAuth.
Credenziali OAuth (per l'accesso agli account Google Ads)
Per autorizzarti come utenti dell'Account Google con accesso agli account Google Ads, devi fornire un insieme di credenziali OAuth.
In genere vengono utilizzati due flussi OAuth: app desktop (installate) o app web. La differenza principale tra le due è che le app desktop devono aprire il browser di sistema e fornire un URI di reindirizzamento locale per gestire le risposte del server di autorizzazione di Google, mentre le app web possono reindirizzare un browser di terze parti arbitrario per completare l'autorizzazione e inviare nuovamente le credenziali al tuo server. La libreria supporta anche il flusso dell'account di servizio meno utilizzato.
- Se autorizzi l'utilizzo delle tue credenziali (flusso dell'app desktop)
- Fai riferimento al flusso per le app desktop OAuth. Sono inclusi tutti i dettagli necessari per l'autorizzazione con le tue credenziali.
- Se esegui l'autorizzazione come utente Google di terze parti (flusso web)
- Consulta il flusso dell'app web OAuth. Questo è un esempio di come configurare l'autorizzazione OAuth per utenti di terze parti произвольных.
- Se esegui l'autorizzazione come utente del dominio Google Apps (flusso dell'account di servizio)
- Consulta il flusso per gli account di servizio OAuth. Questo è un esempio di come configurare l'autorizzazione OAuth per gli utenti del dominio Google Apps.
Se accedi all'account cliente Google Ads tramite un account amministratore Google Ads, devi anche specificare un ID cliente di accesso come descritto di seguito.
ID cliente di accesso (per accedere agli account Google Ads tramite un account amministratore)
(Facoltativo) Specifica l'ID cliente di un account amministratore che consente di accedere all'account di pubblicazione. Questo valore deve essere specificato se accedi all'account del cliente tramite un account amministratore. Non è necessario specificare tutti gli account amministratore nel percorso per l'ID cliente, ma solo l'ID amministratore principale che utilizzi per le autorizzazioni di accesso. Per ulteriori dettagli, consulta la documentazione correlata.
Configura la libreria client con le tue credenziali
Puoi configurare la libreria client con un file di configurazione, variabili di ambiente o tramite programmazione. Per questa guida, utilizzeremo l'approccio del file di configurazione e ci concentreremo sui flussi desktop e web. L'utilizzo di un file di configurazione è in genere un buon approccio se hai un solo insieme di credenziali (ad esempio, gestisci gli account di un singolo amministratore).
Crea un file ~/ads.properties con i seguenti contenuti:
api.googleads.clientId=INSERT_CLIENT_ID_HERE
api.googleads.clientSecret=INSERT_CLIENT_SECRET_HERE
api.googleads.refreshToken=INSERT_REFRESH_TOKEN_HERE
api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE
Sostituisci i segnaposto con le tue credenziali ottenute nel passaggio precedente.
Inoltre, se il token di aggiornamento è per un account amministratore, devi specificare l'ID cliente di questo account come cliente di accesso:
api.googleads.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE
Convalida le credenziali
Per assicurarti che tutto sia configurato correttamente, esegui l'esempio GetCampaigns.
Innanzitutto, vai alla directory google-ads-examples.
$ cd google-ads-examples
Questo esempio richiede un parametro --customerId il cui valore è il tuo ID cliente dell'account Google Ads senza i trattini.
Per eseguire il comando con Gradle:
$ ./gradlew -q runExample --example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"
Esplora altri esempi
Il pacchetto examples in google-ads-examples
contiene diversi esempi utili. La maggior parte degli esempi richiede parametri. Puoi passare i parametri come argomenti (opzione consigliata) o modificare i valori INSERT_XXXXX_HERE nel codice sorgente. Per visualizzare una dichiarazione di utilizzo
per un esempio, passa --help come unico argomento.
Con Gradle:
$ ./gradlew -q runExample --example="basicoperations.GetCampaigns --help"
Puoi anche utilizzare l'attività listExamples in Gradle per elencare tutti gli esempi, gli esempi in una sottodirectory o gli esempi in cui la descrizione include un termine di ricerca.
# List all examples:
$ ./gradlew -q listExamples
# List examples in the 'basicoperations' subdirectory:
$ ./gradlew -q listExamples --subdirectory='basicoperations'
# Search for examples where the description includes 'Performance Max':
$ ./gradlew -q listExamples --searchTerm='Performance Max'