Client installieren und konfigurieren

Wir empfehlen, die Google API-Clientbibliotheken mit der Bid Manager API zu verwenden, HTTP-Anfragen und -Antworten nicht manuell verarbeiten müssen. Die Google API Clientbibliotheken ermöglichen eine bessere Sprachintegration, mehr Sicherheit für Aufrufe, die eine Nutzerautorisierung erfordern.

Die Bid Manager API basiert auf HTTP und JSON. Wenn Sie Anträge lieber bearbeiten möchten, und Antworten manuell eingeben, können Sie jeden Standard-HTTP-Client verwenden.

Clientbibliothek installieren

Wir bieten Clientbibliotheken, die die Bid Manager API in einer Vielzahl von Programmiersprachen. Eine vollständige Liste der Client-Bibliotheken finden Sie in den Beispielen und „Mediatheken“.

In den Entwicklerleitfäden für die Bid Manager API finden Sie Code-Snippets für die folgenden drei Sprachen:

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

Client konfigurieren

Mit OAuth 2.0-Anmeldedaten und einem installierten Client können Sie die Bid Manager API verwenden. So kannst du 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 Datei mit den Clientschlüsseln und generieren Sie Anmeldedaten für die Autorisierung.

    Wenn Sie diesen Schritt zum ersten Mal ausführen, werden Sie aufgefordert, eine Autorisierung zu akzeptieren in Ihrem Browser angezeigt. Bevor Sie zustimmen, müssen Sie mit einem Google-Konto mit Zugriff auf Display- und Video 360 Deine App wird autorisiert , um im Namen des Kontos, in dem Sie gerade angemeldet sind, 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. Einen 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 Datei mit den Clientschlüsseln und generieren Sie Anmeldedaten für die Autorisierung.

    Wenn Sie diesen Schritt zum ersten Mal ausführen, werden Sie aufgefordert, eine Autorisierung zu akzeptieren in Ihrem Browser angezeigt. Bevor Sie zustimmen, müssen Sie mit einem Google-Konto mit Zugriff auf Display- und Video 360 Deine App wird autorisiert , um im Namen des Kontos, in dem Sie gerade angemeldet sind, 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. Einen 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 eine Weiterleitung auf die entsprechende Webseite erfolgt. Für Beispiel: Dieser Code in einer index.php-Datei kann so ausgeführt werden: Befehl und Anmeldedaten, die für die Weiterleitung zu http://localhost:8000 konfiguriert sind, nachdem Authentifizierung:

php -S localhost:8000 -t ./

  1. Laden Sie den PHP-Client für die Google API herunter und installieren Sie ihn.

    Am besten verwenden Sie Composer:

    composer require google/apiclient:^2.12.1

    Fügen Sie nach der Installation den Autoloader hinzu.

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

  2. Erstellen Sie ein Google_Client-Objekt.

    $client = new Google_Client();
  3. Richten Sie den Client ein, leiten Sie bei Bedarf zur Authentifizierungs-URL weiter und rufen Sie ein Zugriffstoken ab.

    Wenn Sie diesen Schritt zum ersten Mal ausführen, werden Sie aufgefordert, eine Autorisierung zu akzeptieren in Ihrem Browser angezeigt. Bevor Sie zustimmen, müssen Sie mit einem Google-Konto mit Zugriff auf Display- und Video 360 Deine App wird autorisiert , um im Namen des Kontos, in dem Sie gerade angemeldet sind, 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. Kunden für das Display- und Video 360 API-Dienst.

    $service = new Google_Service_DoubleClickBidManager($client);