Libreria client dell'API Google Ads per Java

La libreria client per Java è ospitata su GitHub e distribuita tramite Maven Central. Offre diverse funzionalità per aiutarti a utilizzare l'API, tra cui una gestione più semplice delle credenziali e la creazione di client di servizio dell'API Google Ads.

La libreria richiede Java 8 o versioni successive.

Installazione

Utilizza la distinta base (BOM) dell'API Google Ads nel file pom.xml o build.gradle per gestire le versioni delle dipendenze:

<!-- Import the Bill of Materials (BOM) to ensure you're using compatible
     versions of all google-ads libraries. -->
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.api-ads</groupId>
      <artifactId>google-ads-bom</artifactId>
      <version>48.1.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<!-- Add the google-ads dependency, without a version. The version is
     managed by the BOM. -->
<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>google-ads</artifactId>
</dependency>

Puoi anche creare la libreria dall'origine.

Fai la tua prima chiamata API

Per utilizzare l'API Google Ads, devi eseguire diversi passaggi per ottenere l'accesso all'API e configurare i tuoi account Google Ads. Segui la guida rapida, che ti illustra tutti i passaggi importanti, inclusa la configurazione degli account Google Ads.

Utilizzo di base

Consulta la guida all'utilizzo di base per scoprire come configurare un progetto, creare istanze dei client di servizio ed eseguire esempi di codice con la libreria client Java.

Autenticazione e autorizzazione

La libreria client Java supporta diversi approcci all'autenticazione e all'autorizzazione, tra cui i flussi di applicazioni web e desktop OAuth 2.0, i service account e le credenziali predefinite dell'applicazione. Per saperne di più, consulta la guida all'autenticazione e all'autorizzazione.

Configurazione e logging

La libreria client Java supporta più opzioni di configurazione (tra cui file ads.properties, variabili di ambiente e configurazione programmatica) e funzionalità di logging per il monitoraggio delle richieste e delle risposte API.

Utilità

La libreria client Java include classi di utilità per migliorare l'usabilità dell'API. Per saperne di più, consulta le seguenti guide:

  • FieldMasks: helper per la creazione e il calcolo delle maschere di campo di aggiornamento.
  • ResourceNames: utilità per la formattazione delle stringhe dei nomi delle risorse delle entità.
  • Operazioni a lunga esecuzione: strumenti di supporto per il monitoraggio e la gestione delle operazioni API asincrone.

Ottimizza l'applicazione

Consulta la guida all'utilizzo avanzato per suggerimenti su come ottimizzare i timeout, le impostazioni di ripetizione, la latenza di avvio e la gestione delle dipendenze dell'applicazione.