L'utilizzo di base della libreria client Java è il seguente:
Crea un nuovo progetto Maven o Gradle
Crea un nuovo progetto Maven o Gradle nell'IDE che preferisci. Gli artefatti vengono pubblicati nel repository Maven Central.
Utilizza la distinta base (BOM) dell'API Google Ads per gestire le versioni delle dipendenze.
Se vuoi eseguire gli esempi di codice precompilati inclusi nel modulo google-ads-examples, clona il repository google-ads-java da GitHub o compila dal codice sorgente. Se esegui la
compilazione dal codice sorgente, assicurati di attivare l'elaborazione delle annotazioni nel tuo IDE.
Configurare l'accesso API
Per connetterti all'API Google Ads, devi fornire le credenziali di autenticazione e autorizzazione. Per informazioni dettagliate sulle credenziali richieste e su come configurare la libreria client, consulta la guida all'autenticazione e all'autorizzazione.
Effettuare la prima chiamata
Una volta configurate le credenziali, puoi effettuare la tua prima chiamata API.
Per convalidare le tue credenziali ed effettuare la prima chiamata utilizzando il repository
google-ads-java clonato, esegui l'esempioGetCampaigns.
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"
Per eseguire con Maven:
mvn exec:java \
-Dexec.mainClass="com.google.ads.googleads.examples.basicoperations.GetCampaigns" \
-Dexec.args="--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 trasmettere i parametri come argomenti (opzione consigliata) o
modificare i valori segnaposto INSERT_..._HERE nel codice sorgente. Per visualizzare un esempio di
estratto conto, 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'