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 centrale Maven.
Utilizza la distinta base (BOM) dell'API Google Ads per gestire le versioni delle dipendenze.
Se vuoi eseguire gli esempi di codice pre-pacchettizzati inclusi nel modulo google-ads-examples, clona il repository google-ads-java da GitHub o esegui la build dal codice sorgente. Se stai creando l'app dal codice sorgente, assicurati di attivare l'elaborazione delle annotazioni nel tuo IDE.
Configura 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.
Fai la tua prima chiamata
Dopo aver configurato 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'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 l'esecuzione con Gradle:
./gradlew -q runExample \
--example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"
Per l'esecuzione 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 passare i parametri come argomenti (opzione consigliata) o modificare i valori segnaposto INSERT_..._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'