Client installieren und konfigurieren

Wir empfehlen, die Google API-Clientbibliotheken mit der Display & Video 360 API zu verwenden. Wenn Sie Clientbibliotheken verwenden, müssen Sie HTTP-Anfragen nicht manuell erstellen und Antworten nicht manuell parsen. Clientbibliotheken können eine bessere Sprachintegration sowie eine höhere Sicherheit bieten und auch Aufrufe unterstützen, die eine Nutzerautorisierung erfordern.

Die Display & Video 360 API basiert auf HTTP und JSON. Sie können auch einen beliebigen Standard-HTTP-Client verwenden, um Anfragen zu stellen und Antworten zu parsen.

Clientbibliothek installieren

Wir bieten Clientbibliotheken an, die die Display & Video 360 API in verschiedenen Programmiersprachen unterstützen. Eine vollständige Liste der Clientbibliotheken finden Sie auf der Seite „Beispiele und Bibliotheken“.

In den Entwicklerleitfäden zur Display & Video 360 API finden Sie Code-Snippets für die folgenden Sprachen:

Zusätzlich zu Code-Snippets in unseren Anleitungen bieten wir vollständige Integrationsbeispiele in diesen Sprachen an. Diese Beispiele finden Sie in unserem GitHub-Repository mit Beispielen für die Display & Video 360 API.

Client konfigurieren

Mit OAuth 2.0-Anmeldedaten und einer installierten Clientbibliothek können Sie die Display & Video 360 API verwenden. So autorisieren und konfigurieren Sie Ihren Client:

Java

Importieren Sie die erforderlichen Bibliotheken.

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;

Laden Sie die Datei mit den Clientschlüsseln und generieren Sie Autorisierungsanmeldedaten.

Wenn Sie diesen Schritt zum ersten Mal ausführen, werden Sie aufgefordert, eine Autorisierungsaufforderung in Ihrem Browser zu akzeptieren. Bevor Sie die Einladung annehmen, müssen Sie mit einem Google-Konto angemeldet sein, das Zugriff auf Display & Video 360 hat. Ihre App wird autorisiert, im Namen des jeweils angemeldeten Kontos auf Daten zuzugreifen. Weitere Informationen finden Sie in unserem Konzeptleitfaden zu Nutzerberechtigungen.

// 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");

Autorisierten API-Client erstellen

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

Python

Importieren Sie die erforderlichen Bibliotheken.

from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient import discovery

Laden Sie die Datei mit den Clientschlüsseln und generieren Sie Autorisierungsanmeldedaten.

Wenn Sie diesen Schritt zum ersten Mal ausführen, werden Sie aufgefordert, eine Autorisierungsaufforderung in Ihrem Browser zu akzeptieren. Bevor Sie die Einladung annehmen, müssen Sie mit einem Google-Konto angemeldet sein, das Zugriff auf Display & Video 360 hat. Ihre App wird autorisiert, im Namen des jeweils angemeldeten Kontos auf Daten zuzugreifen. Weitere Informationen finden Sie in unserem Konzeptleitfaden zu Nutzerberechtigungen.
```
# 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()
```

Autorisierten API-Client erstellen

# 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

In diesem Beispiel wird davon ausgegangen, dass Sie PHP mit einem integrierten Webserver ausführen und Ihre Anmeldedaten so konfiguriert haben, dass sie zur entsprechenden Webseite weitergeleitet werden. Dieser Code in einer index.php-Datei kann beispielsweise mit dem folgenden Befehl und Anmeldedaten ausgeführt werden, die so konfiguriert sind, dass nach der Authentifizierung zu http://localhost:8000 weitergeleitet wird:

php -S localhost:8000 -t ./

Google API-Client für PHP herunterladen und installieren

Die bevorzugte Methode ist die Verwendung von Composer:
```
composer require google/apiclient:^2.18.2 google/apiclient-services:=0.396.0
```
Nach der Installation müssen Sie den Autoloader einfügen:
```
require_once '/path/to/your-project/vendor/autoload.php';
```
Google_Client-Objekt erstellen
```
$client = new Google_Client();
```

Client einrichten, bei Bedarf zur Authentifizierungs-URL weiterleiten und Zugriffstoken abrufen:

// 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);

Client für den Display & Video 360 API-Dienst erstellen
```
$service = new Google_Service_DisplayVideo($client);
```

Client installieren und konfigurieren Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Clientbibliothek installieren

Client konfigurieren

Java

Python

PHP

Client installieren und konfigurieren