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. I nostri artefatti vengono pubblicati nel repository Maven Central.
Ti consigliamo di utilizzare la distinta materiali (BOM) dell'API Google Ads per gestire le versioni delle dipendenze.
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 compilazione dal codice sorgente, assicurati di attivare l'elaborazione delle annotazioni nell'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, 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 è 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
parametri. Puoi passare i parametri come argomenti (opzione consigliata) o
modificare i valori di 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'