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 che preferisci. I nostri artefatti vengono pubblicati nel repository centrale Maven.
La dipendenza Maven è:
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads</artifactId>
<version>38.0.0</version>
</dependency>
La dipendenza Gradle è:
implementation 'com.google.api-ads:google-ads:38.0.0'
Puoi anche creare dal codice sorgente. Ai fini di questa guida, si presuppone che tu abbia configurato un progetto con le dipendenze richieste disponibili.
Se esegui la build dal codice sorgente, assicurati di attivare l'elaborazione delle annotazioni nell'IDE.
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 l'accesso all'API)
Il token sviluppatore è collegato a un account amministratore e si trova nell'interfaccia web di Google Ads.
Sebbene il token sviluppatore sia collegato a un account amministratore, non fornisce l'accesso a questo 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 autorizzare gli 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 (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 tuo server. La libreria supporta anche il flusso dell'account di servizio meno utilizzato.
- Se autorizzi l'utilizzo delle tue credenziali (flusso dell'app per computer)
- Fai riferimento al flusso dell'app desktop OAuth. Sono inclusi tutti i dettagli necessari per l'autorizzazione con le tue credenziali.
- Se autorizzi come utente Google di terze parti (flusso web)
- Consulta il flusso dell'app web OAuth. Questo fornisce un esempio di come configurare l'autorizzazione OAuth per utenti di terze parti arbitrari.
- Se autorizzi l'accesso come utente del dominio Google Apps (flusso dell'account di servizio)
- Consulta il flusso dell'account di servizio OAuth. Questo esempio mostra 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 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. Questo deve essere specificato se l'accesso all'account cliente avviene tramite un account amministratore. Non è necessario specificare tutti gli account manager nel percorso dell'ID cliente, ma solo l'ID manager di primo livello che utilizzi per le autorizzazioni di accesso. Per maggiori 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, utilizzeremo l'approccio del file di configurazione e ci concentreremo sui flussi web e desktop. L'utilizzo di un file di configurazione è in genere un buon approccio se hai un solo insieme di credenziali (ad esempio, se gestisci account in un unico account amministratore).
Crea un file ~/ads.properties con il seguente contenuto:
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
Convalidare le credenziali
Per assicurarci che tutto sia configurato correttamente, eseguiamo l'esempio GetCampaigns.
Innanzitutto, vai alla directory google-ads-examples.
cd google-ads-examples
Questo esempio richiede un parametro --customerId in cui il valore è l'ID cliente del tuo 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
parametri. Puoi passare i parametri come argomenti (opzione consigliata) 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'