Installa e configura il client

Ti consigliamo di utilizzare le librerie client dell'API di Google con l'API Display & Video 360. Utilizzando le librerie client, non devi effettuare manualmente richieste HTTP e analizzare le risposte. Le librerie client possono fornire una migliore integrazione del linguaggio, una maggiore sicurezza e supporto per effettuare chiamate che richiedono l'autorizzazione dell'utente.

L'API Display & Video 360 si basa su HTTP e JSON. Se preferisci, puoi utilizzare qualsiasi client HTTP standard per effettuare richieste e analizzare le risposte.

Installare una libreria client

Offriamo librerie client che supportano l'API Display & Video 360 in una serie di linguaggi di programmazione. Per un elenco completo delle librerie client, consulta la nostra pagina Esempi e librerie.

Le guide per gli sviluppatori dell'API Display & Video 360 forniscono snippet di codice per i seguenti linguaggi:

Oltre agli snippet di codice nelle nostre guide, offriamo esempi di integrazione completi in queste lingue. Per questi esempi, consulta il nostro repository GitHub di esempi di API Display & Video 360.

Configura il client

Con le credenziali OAuth 2.0 e una libreria client installata, puoi utilizzare l'API Display & Video 360. Ecco come autorizzare e configurare il client:

Java

  1. Importa le librerie necessarie.

    import static java.nio.charset.StandardCharsets.UTF_8;
import com.google.api.client.auth.oauth2.Credential;
import com.google.api.client.extensions.java6.auth.oauth2.AuthorizationCodeInstalledApp;
import com.google.api.client.extensions.jetty.auth.oauth2.LocalServerReceiver;
import com.google.api.client.googleapis.auth.oauth2.GoogleAuthorizationCodeFlow;
import com.google.api.client.googleapis.auth.oauth2.GoogleClientSecrets;
import com.google.api.client.googleapis.util.Utils;
import com.google.api.services.displayvideo.v4.DisplayVideo;
import com.google.api.services.displayvideo.v4.DisplayVideo.Advertisers;
import com.google.api.services.displayvideo.v4.model.Advertiser;
import com.google.api.services.displayvideo.v4.model.ListAdvertisersResponse;
import java.io.Reader;
import java.nio.file.Files;
import java.nio.file.Paths;

  2. Carica il file client secret e genera le credenziali di autorizzazione.

    La prima volta che esegui questo passaggio, ti viene chiesto di accettare una richiesta di autorizzazione nel browser. Prima di accettare, assicurati di aver eseguito l'accesso con un Account Google che abbia accesso a Display & Video 360. La tua app sarà autorizzata ad accedere ai dati per conto dell'account attualmente connesso. Per ulteriori dettagli, consulta la nostra guida al concetto di autorizzazioni utente. 

    // Read client secrets file.
GoogleClientSecrets clientSecrets;
try (Reader reader = Files.newBufferedReader(Paths.get(path-to-client-secrets-file), UTF_8)) {
  clientSecrets = GoogleClientSecrets.load(Utils.getDefaultJsonFactory(), reader);
}

// Generate authorization credentials.
// Set up the authorization code flow.
GoogleAuthorizationCodeFlow flow =
    new GoogleAuthorizationCodeFlow.Builder(
        Utils.getDefaultTransport(),
        Utils.getDefaultJsonFactory(),
        clientSecrets,
        oauth-scopes)
    .build();

Credential credential =
    new AuthorizationCodeInstalledApp(flow, new LocalServerReceiver()).authorize("user");

  3. Crea un client API autorizzato.

    // Create authorized API client.
DisplayVideo service =
    new DisplayVideo.Builder(credential.getTransport(), credential.getJsonFactory(), credential)
        .setApplicationName("displayvideo-java-installed-app-sample")
        .build();

Python

  1. Importa le librerie necessarie.

    from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient import discovery

  2. Carica il file client secret e genera le credenziali di autorizzazione.

    La prima volta che esegui questo passaggio, ti viene chiesto di accettare una richiesta di autorizzazione nel browser. Prima di accettare, assicurati di aver eseguito l'accesso con un Account Google che abbia accesso a Display & Video 360. La tua app sarà autorizzata ad accedere ai dati per conto dell'account attualmente connesso. Per ulteriori dettagli, consulta la nostra guida al concetto di autorizzazioni utente. 

    # Set up a flow object to create the credentials using the
# client secrets file and OAuth scopes.
credentials = InstalledAppFlow.from_client_secrets_file(
    path-to-client-secrets-file, oauth-scopes).run_local_server()

  3. Crea un client API autorizzato.

    # Build the discovery document URL.
discovery_url = f'https://displayvideo.googleapis.com/$discovery/rest?version=v4'

# Build the API service.
service = discovery.build(
    'displayvideo',
    'v4',
    discoveryServiceUrl=discovery_url,
    credentials=credentials)

PHP

Questo esempio presuppone che tu stia eseguendo PHP con un server web incorporato e che tu abbia configurato le tue credenziali per il reindirizzamento alla pagina web pertinente. Ad esempio, questo codice, in un file index.php, può essere eseguito utilizzando il seguente comando e le credenziali configurate per reindirizzare a http://localhost:8000 dopo l'autenticazione:

php -S localhost:8000 -t ./

  1. Scarica e installa il client PHP delle API Google.

    Il metodo preferito è l'utilizzo di Composer:

    composer require google/apiclient:^2.18.2 google/apiclient-services:=0.396.0

    Una volta installato, assicurati di includere il caricatore automatico:

    require_once '/path/to/your-project/vendor/autoload.php';

  2. Crea un oggetto Google_Client.

    $client = new Google_Client();

  3. Configura il client, reindirizza all'URL di autenticazione se necessario e recupera un token di accesso.

    La prima volta che esegui questo passaggio, ti viene chiesto di accettare una richiesta di autorizzazione nel browser. Prima di accettare, assicurati di aver eseguito l'accesso con un Account Google che abbia accesso a Display & Video 360. La tua app sarà autorizzata ad accedere ai dati per conto dell'account attualmente connesso. Per ulteriori dettagli, consulta la nostra guida al concetto di autorizzazioni utente. 

    // Set up the client.
$client->setApplicationName('DV360 API PHP Samples');
$client->addScope(oauth-scope);
$client->setAccessType('offline');
$client->setAuthConfigFile(path-to-client-secrets-file);

// If the code is passed, authenticate. If not, redirect to authentication page.
if (isset($_GET['code'])) {
  $client->authenticate($_GET['code']);
} else {
  $authUrl = $client->createAuthUrl();
  header('Location: ' . $authUrl);
}

// Exchange authorization code for an access token.
$accessToken = $client->getAccessToken();
$client->setAccessToken($accessToken);

  4. Crea un client per il servizio API Display & Video 360.

    $service = new Google_Service_DisplayVideo($client);