Java

Google fornisce una libreria client Java per interagire con l'API Ad Manager. Ti consigliamo di utilizzare la libreria client con Apache Maven o Gradle.

Per iniziare, crea un nuovo progetto nell'IDE che preferisci o aggiungi la dipendenza a un progetto esistente. Google pubblica gli artefatti della libreria client nel repository centrale Maven come com.google.api-ads/ad-manager.

Maven 

<!-- pom.xml -->
<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>ad-manager</artifactId>
  <version>0.1.0</version>
</dependency>

Gradle 

implementation 'com.google.api-ads:ad-manager:0.1.0'

Configurare le credenziali

La libreria client Java utilizza OAuth2 e le Credenziali predefinite dell'applicazione (ADC) per l'autenticazione.

ADC cerca le credenziali in ordine nelle seguenti posizioni:

  1. variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS.
  2. Credenziali utente configurate tramite Google Cloud CLI (gcloud CLI).
  3. Quando viene eseguito su Google Cloud, il service account collegato alla risorsa Google Cloud.

Per creare e configurare le credenziali ADC, consulta la sezione Autenticazione.

Effettua la tua prima richiesta

Ogni servizio ha un oggetto ServiceClient con metodi sincroni e asincroni per ogni metodo REST. L'esempio seguente legge un Network in modo sincrono.

import com.google.ads.admanager.v1.GetNetworkRequest;
import com.google.ads.admanager.v1.Network;
import com.google.ads.admanager.v1.NetworkName;
import com.google.ads.admanager.v1.NetworkServiceClient;

public class SyncGetNetwork {

  public static void main(String[] args) throws Exception {
    syncGetNetwork();
  }

  public static void syncGetNetwork() throws Exception {
    try (NetworkServiceClient networkServiceClient = NetworkServiceClient.create()) {
      GetNetworkRequest request =
          GetNetworkRequest.newBuilder()
              .setName(NetworkName.of("[NETWORK_CODE]").toString())
              .build();
      Network response = networkServiceClient.getNetwork(request);
    }
  }
}

Per esempi di altri metodi e risorse, consulta il repository GitHub googleapis/google-cloud-java.

Registra richieste e risposte HTTP

La classe com.google.api.client.http.HttpTransport effettua tutte le richieste HTTP. Questa classe utilizza java.util.logging (JUL) per registrare i dettagli delle richieste e delle risposte HTTP, inclusi URL, intestazioni e contenuti.

Per attivare la registrazione, imposta il logger per questa classe su un livello di log pari a CONFIG o superiore. I passaggi variano a seconda dell'implementazione della registrazione che utilizzi.

LUG

Per attivare il logging, imposta com.google.api.client.http.level su CONFIG o su un valore superiore nel file logging.properties.

handlers=java.util.logging.ConsoleHandler
com.google.api.client.http.level=CONFIG
java.util.logging.ConsoleHandler.level=CONFIG

In alternativa, puoi attivare la registrazione nel codice Java.


import com.google.api.client.http.HttpTransport;
import java.util.logging.ConsoleHandler;
import java.util.logging.Level;
import java.util.logging.Logger;

public static void enableLogging() {
  Logger logger = Logger.getLogger(HttpTransport.class.getName());
  logger.setLevel(Level.CONFIG);
  ConsoleHandler handler = new ConsoleHandler();
  handler.setLevel(Level.CONFIG);
  logger.addHandler(handler);
}

Log4j

Se utilizzi Log4j per la registrazione, puoi utilizzare l'adattatore di logging JDK di Log4j per registrare i messaggi JUL. Puoi configurarlo tramite un SystemProperty o utilizzando Log4jBridgeHandler e un file JUL logging.properties.

Proprietà sistema

-Djava.util.logging.manager=org.apache.logging.log4j.jul.LogManager

Log4j Bridge Handler

handlers = org.apache.logging.log4j.jul.Log4jBridgeHandler
org.apache.logging.log4j.jul.Log4jBridgeHandler.propagateLevels = true

Queste impostazioni scrivono i log dell'API Ad Manager in qualsiasi logger con un livello di CONFIG o superiore. Il seguente file log4j2.xml di esempio configura un logger che scrive in System.out.

<?xml version="1.0" encoding="UTF-8"?>
<Configuration>
  <Appenders>
    <Console name="Console" target="SYSTEM_OUT">
      <PatternLayout pattern="%m%n"/>
    </Console>
  </Appenders>
  <Loggers>
    <Logger name="com.google.api.client.http.HttpTransport" level="debug">
      <AppenderRef ref="Console"/>
    </Logger>
    <Root level="error">
      <AppenderRef ref="Console"/>
    </Root>
  </Loggers>
</Configuration>

Gestisci gli errori

Tutti gli errori dell'API Ad Manager sono sottoclassi di ApiException nella libreria client Java.

Tutti gli errori, ad eccezione di 404 Not Found e 401 Unauthorized, contengono ErrorDetails con informazioni aggiuntive.

Errori di analisi

Il campo Motivo dell'errore identifica in modo univoco i tipi di errore. Utilizza questo campo per determinare come gestire l'errore.

ErrorDetails errorDetails = apiException.getErrorDetails();
if (errorDetails != null) {
  // Unique error code in UPPER_SNAKE_CASE.
  String errorCode = errorDetails.getReason();
}

Gli errori dell'API Ad Manager includono anche un request_id univoco che puoi fornire all'assistenza per ricevere aiuto con la risoluzione dei problemi. L'esempio seguente estrae request_id.

ErrorDetails errorDetails = apiException.getErrorDetails();
if (errorDetails != null && errorDetails.getRequestInfo() != null) {
  // Unique request identifier.
  String requestId = errorDetails.getRequestInfo().getRequestId();
}

Costruisci nomi delle risorse

La libreria client fornisce classi helper per creare nomi di risorse dagli ID.

import com.google.ads.admanager.v1.OrderName;

// ...

//  Constructs a String in the format:
//  "networks/{networkCode}/orders/{orderId}"
OrderName.of("123", "789");

Configurare le impostazioni proxy

La libreria client Java rispetta sia le impostazioni delle proprietà di sistema http.proxyHost che https.proxyHost. Per ulteriori dettagli su queste impostazioni, vedi Networking Java e proxy.