Client installieren und konfigurieren

Wir empfehlen, die Google API-Clientbibliotheken mit der Bid Manager API zu verwenden, damit Sie HTTP-Anfragen und ‑Antworten nicht manuell verarbeiten müssen. Die Google API-Clientbibliotheken bieten eine bessere Sprachintegration sowie eine höhere Sicherheit und unterstützen auch Aufrufe, die eine Nutzerautorisierung erfordern.

Die Bid Manager API basiert auf HTTP und JSON. Wenn Sie Anfragen und Antworten lieber manuell verarbeiten möchten, können Sie einen beliebigen Standard-HTTP-Client verwenden.

Clientbibliothek installieren

Wir bieten Clientbibliotheken an, die die Bid Manager API in verschiedenen Programmiersprachen unterstützen. Eine vollständige Liste der Clientbibliotheken finden Sie auf dem Tab „Beispiele und Bibliotheken“.

Die Entwicklerleitfäden für die Bid Manager API enthalten Code-Snippets für die folgenden drei Sprachen:

• Java
• Python
• PHP

Vollständige Integrationsbeispiele in diesen Sprachen finden Sie in unserem GitHub-Repository mit Bid Manager API-Beispielen.

Client konfigurieren

Mit OAuth 2.0-Anmeldedaten und einer installierten Clientbibliothek können Sie die Bid Manager API verwenden. So autorisieren und konfigurieren Sie Ihren Client:

Java

1. 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.doubleclickbidmanager.DoubleClickBidManager;
   import java.io.Reader;
   import java.nio.file.Files;
   import java.nio.file.Paths;

2. Laden Sie die Secrets-Datei des Clients 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 den Deal 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.

   // 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. Autorisierten API-Client erstellen

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

Python

1. Importieren Sie die erforderlichen Bibliotheken.

   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient import discovery

2. Laden Sie die Secrets-Datei des Clients 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 den Deal 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.

   # 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. Autorisierten API-Client erstellen

   # Build the discovery document URL.
   discovery_url = f'https://doubleclickbidmanager.googleapis.com/$discovery/rest?version=v2'
   
   # Build the API service.
   service = discovery.build(
       'doubleclickbidmanager',
       'v2',
       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 ./

1. Google API-Client für PHP herunterladen und installieren

   Die bevorzugte Methode ist Composer:

   composer require google/apiclient:^2.12.1

   Nach der Installation müssen Sie den Autoloader

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

2. Google_Client-Objekt erstellen

   $client = new Google_Client();

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

   Wenn Sie diesen Schritt zum ersten Mal ausführen, werden Sie aufgefordert, eine Autorisierungsaufforderung in Ihrem Browser zu akzeptieren. Bevor Sie den Deal 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.

   // Set up the client.
   $client->setApplicationName('DBM 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. Client für den Display & Video 360 API-Dienst erstellen

   $service = new Google_Service_DoubleClickBidManager($client);