Unisciti a noi in diretta su Discord nel server della community Google Advertising and Measurement e su YouTube il 15 ottobre alle 16:00 CET. Parleremo delle nuove funzionalità aggiunte nella versione 26 dell'API Google Ads.

Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Utilizzo di base

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 precompilati inclusi nel google-ads-examples modulo, clona il google-ads-java repository da GitHub o esegui la build dal codice sorgente. Se esegui la build dal codice sorgente, assicurati di attivare l'elaborazione delle annotazioni nell'IDE.

Configura l'accesso API

Per connetterti all'API Google Ads, devi fornire le credenziali di autenticazione e autorizzazione. Per maggiori dettagli sulle credenziali richieste e su come configurare la libreria client, consulta la guida Autenticazione e autorizzazione.

Effettua la tua prima chiamata

Dopo aver configurato le credenziali, puoi effettuare la tua prima chiamata API.

Per convalidare le credenziali ed effettuare la tua prima chiamata utilizzando il repository clonato google-ads-java, esegui l'esempio GetCampaigns.

Innanzitutto, vai alla directory google-ads-examples:

cd google-ads-examples

Questo esempio richiede un parametro --customerId il cui 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 di esempi in google-ads-examples contiene diversi esempi utili. La maggior parte degli esempi richiede dei parametri. Puoi passare i parametri come argomenti (opzione consigliata) o modificare i valori dei 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'