Client installieren und konfigurieren

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.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. Laden Sie die Datei mit den Clientgeheimnissen und generieren Sie Autorisierungsanmeldedaten.

   Wenn Sie diesen Schritt zum ersten Mal ausführen, werden Sie aufgefordert, eine Autorisierungsaufforderung in Ihrem Browser zu akzeptieren. Achten Sie vor dem Akzeptieren darauf, dass Sie mit einem Google-Konto angemeldet sind, das Zugriff auf Display & Video 360 hat. Ihre App wird autorisiert, auf Daten im Namen des Kontos zuzugreifen, mit dem Sie derzeit angemeldet sind. Weitere Informationen finden Sie in unserem Leitfaden zum Konzept der Nutzerberechtigungen Leitfaden für weitere Details.

   // 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. Erstellen Sie einen autorisierten API-Client.

   // Create authorized API client.
   DisplayVideo service =
       new DisplayVideo.Builder(credential.getTransport(), credential.getJsonFactory(), credential)
           .setApplicationName("displayvideo-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 Clientgeheimnissen und generieren Sie Autorisierungsanmeldedaten.

   Wenn Sie diesen Schritt zum ersten Mal ausführen, werden Sie aufgefordert, eine Autorisierungsaufforderung in Ihrem Browser zu akzeptieren. Achten Sie vor dem Akzeptieren darauf, dass Sie mit einem Google-Konto angemeldet sind, das Zugriff auf Display & Video 360 hat. Ihre App wird autorisiert, auf Daten im Namen des Kontos zuzugreifen, mit dem Sie derzeit angemeldet sind. Weitere Informationen finden Sie in unserem Leitfaden zum Konzept der Nutzerberechtigungen Leitfaden für weitere Details.

   # 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. Erstellen Sie einen autorisierten API-Client.

   # 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 sie nach der Authentifizierung zu http://localhost:8000 weiterleiten:

php -S localhost:8000 -t ./

1. Laden Sie den Google API-PHP-Client herunter und installieren Sie ihn.

   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';
   

2. Erstellen Sie ein Google_Client-Objekt.

   $client = new Google_Client();
   

3. Richten Sie den Client ein, leiten Sie ihn 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 Autorisierungsaufforderung in Ihrem Browser zu akzeptieren. Achten Sie vor dem Akzeptieren darauf, dass Sie mit einem Google-Konto angemeldet sind, das Zugriff auf Display & Video 360 hat. Ihre App wird autorisiert, auf Daten im Namen des Kontos zuzugreifen, mit dem Sie derzeit angemeldet sind. Weitere Informationen finden Sie in unserem Leitfaden zum Konzept der Nutzerberechtigungen Leitfaden für weitere Details.

   // 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. Erstellen Sie einen Client für den Display &Video 360 API-Dienst.

   $service = new Google_Service_DisplayVideo($client);