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 centrale di Maven.
Ti consigliamo di utilizzare la distinta materiali dell'API Google Ads (BOM) per gestire le versioni delle dipendenze.
Puoi anche eseguire la build 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 abilitare 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 informazioni dettagliate sulle credenziali richieste e su come configurare la libreria client, consulta la Authentication and Authorization guide.
Effettua la tua prima chiamata
Dopo aver configurato le credenziali, puoi effettuare la tua prima chiamata API.
Per convalidare le credenziali ed effettuare la prima chiamata, 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"
Esplora altri esempi
Il pacchetto di esempi 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'