Ti consigliamo di utilizzare la libreria client con Apache Maven (o Gradle).
Crea un nuovo progetto Maven/Gradle
Crea un nuovo progetto Maven/Gradle nell'IDE di tua scelta. I nostri artefatti vengono pubblicati nel repository centrale Maven.
La dipendenza Maven è:
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads</artifactId>
<version>31.0.0</version>
</dependency>
La dipendenza Gradle è:
implementation 'com.google.api-ads:google-ads:31.0.0'
Puoi anche creare dal codice sorgente. Ai fini di questa guida, si presume che tu abbia una configurazione di progetto con le dipendenze richieste disponibili.
Ottenere le credenziali per l'autenticazione con l'API
L'accesso all'API Google Ads richiede credenziali OAuth e un token sviluppatore dell'API Google Ads. Questa sezione spiega cosa sono, come vengono utilizzati e come vengono ottenuti.
Token sviluppatore (per accedere all'API)
Il token sviluppatore è collegato a un account amministratore e è disponibile nell'interfaccia web di Google Ads.
Sebbene il token sviluppatore sia collegato a un account amministratore, non consente di accedere a questo account. Il token sviluppatore concede invece l'accesso all'API in generale e l'accesso a livello di account è configurato tramite OAuth.
Credenziali OAuth (per l'accesso agli account Google Ads)
Per concedere l'autorizzazione come utenti dell'Account Google con accesso agli account Google Ads, devi fornire un set di credenziali OAuth.
Generalmente vengono utilizzati due flussi OAuth: app desktop (installata) o app web. La differenza principale tra i 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 le credenziali al server. La libreria supporta anche il flusso dell'account di servizio meno utilizzato.
- Se autorizzi l'uso delle tue credenziali (flusso dell'app desktop)
- Fai riferimento al flusso dell'app desktop OAuth. inclusi tutti i dettagli necessari per l'autorizzazione con le tue credenziali.
- Se concedi l'autorizzazione come utente Google di terze parti (flusso web)
- Fai riferimento al flusso dell'app web OAuth. Questo fornisce un esempio di come configurare l'autorizzazione OAuth per utenti di terze parti arbitrari.
- Se autorizzi l'utente come utente del dominio Google Apps (flusso dell'account di servizio)
- Fai riferimento al flusso dell'account di servizio OAuth. Ecco un esempio di come configurare l'autorizzazione OAuth per gli utenti del dominio Google Apps.
Se puoi accedere all'account cliente Google Ads tramite un account amministratore Google Ads, devi specificare anche un ID cliente di accesso come descritto di seguito.
ID cliente di accesso (per l'accesso agli account Google Ads tramite un account amministratore)
(Facoltativo) Specifica l'ID cliente di un account amministratore che concede l'accesso all'account di pubblicazione. È necessario specificare questo valore se l'accesso all'account del cliente avviene tramite un account amministratore. Non è necessario specificare tutti gli account amministratore nel percorso dell'ID cliente, ma solo l'ID amministratore di livello più alto 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 in modo programmatico. Per questa guida, useremo l'approccio basato su 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 set di credenziali (ad esempio, gestisci gli account in un unico gestore).
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 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 accertarci che sia tutto configurato correttamente, eseguiremo l'esempio GetCampagne.
Innanzitutto, accedi alla directory google-ads-examples.
$ cd google-ads-examples
Questo esempio richiede un parametro --customerId in cui il valore è il tuo
ID cliente dell'account Google Ads senza trattini.
Per eseguire 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 l'uso di parametri. Puoi passare i parametri come argomenti (consigliato) o
modificare i valori INSERT_XXXXX_HERE nel codice sorgente. Per visualizzare un'istruzione 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'