クライアントをインストールして構成する

Display & Video 360 API で Google API クライアントライブラリを使用することをおすすめします。クライアントライブラリを使用すると、HTTP リクエストを手動で作成してレスポンスを解析する必要がなくなります。クライアントライブラリを使用すると、言語の統合性が向上し、セキュリティが強化され、ユーザー認証が必要な呼び出しの作成がサポートされます。

Display & Video 360 API は HTTP と JSON をベースに構築されています。必要に応じて、標準の HTTP クライアントを使用してリクエストを送信し、レスポンスを解析することもできます。

クライアントライブラリをインストールする

Google では、さまざまなプログラミング言語で Display & Video 360 API をサポートするクライアントライブラリを提供しています。クライアントライブラリの完全なリストについては、サンプルとライブラリのページをご覧ください。

ディスプレイ＆ビデオ 360 API デベロッパーガイドでは、次の言語のコードスニペットを提供しています。

ガイドのコードスニペットに加えて、これらの言語で完全な統合例を提供しています。これらのサンプルについては、ディスプレイ＆ビデオ 360 API の例の GitHub リポジトリをご覧ください。

クライアントを設定する

OAuth 2.0 認証情報とインストール済みのクライアントライブラリがあれば、ディスプレイ＆ビデオ 360 API を使用する準備は完了です。クライアントを承認して構成する方法は次のとおりです。

Java

必要なライブラリをインポートします。

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;

クライアントのシークレットファイルを読み込み、認証情報を生成する

この手順を初めて行う際には、認証を求めるメッセージがブラウザに表示されます。承認する前に、ディスプレイ＆ビデオ 360 へのアクセス権を持つ Google アカウントでログインしていることをご確認ください。現在ログインしているアカウントに代わって、アプリがデータにアクセスすることが認証されます。詳しくは、ユーザー権限のコンセプトガイドをご覧ください。

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

認証済み API クライアントを作成します。

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

Python