Display & Video 360 API は、ディスプレイ＆ビデオ 360 プラットフォームのプログラマティック インターフェースです。Display & Video 360 API を使用すると、ディスプレイ＆ビデオ 360 の複雑なワークフローを自動化できます。Display & Video 360 API で実行できるタスクの例を次に示します。
このガイドでは、Display & Video 360 API の使用を開始する方法について説明します。
前提条件
Display & Video 360 API を使用するには、次の手順が必要です。
Google アカウントが必要です。Google API Console でプロジェクトを作成するには、Google アカウントが必要です。すでにアカウントをお持ちの場合は、準備が整っています。テスト用に別の Google アカウントを取得することもできます。
ディスプレイ＆ビデオ 360 へのアクセス権が必要です。API を使用するには、ディスプレイ＆ビデオ 360 プロダクトへのアクセス権が必要です。組織ですでにディスプレイ＆ビデオ 360 の契約を締結している場合は、Google アカウントに適切な権限を持つユーザー プロフィールが作成されていることを確認してください。そうでない場合は、Google のセールスチームにお問い合わせください。
ディスプレイ＆ビデオ 360 を試してみることをおすすめします。この API ドキュメントは、ディスプレイ＆ビデオ 360 を使用したことがあること、ウェブ プログラミングの概念とウェブ用のデータ形式に精通していることを前提としています。ディスプレイ＆ビデオ 360 を初めて使用する場合は、コードを作成する前にウェブ UI をお試しください。
プロジェクトを選択
Google API Console でプロジェクトを作成または選択して API を有効にする必要があります。
新しいプロジェクトを作成するか、既存のプロジェクトを使用できます。
新しいプロジェクトを作成
Google API Console の手順に沿ってプロジェクトを作成し、Display & Video 360 API を自動的に有効にします。
既存のプロジェクトを使用する
既存のプロジェクトで Display & Video 360 API を手動で有効にする方法は次のとおりです。
プロジェクトで API を有効にする手順は、次のとおりです。
- Google API コンソールで API ライブラリを開きます。プロンプトが表示されたら、既存のプロジェクトのいずれかを選択するか、新しいプロジェクトを作成します。API ライブラリには、利用できるすべての API がプロダクト ファミリーと人気度によって分類され、表示されます。
- 有効にする API がリストで見当たらない場合は、検索して見つけます。
- 有効にする API を選択し、[有効にする] ボタンをクリックします。
- プロンプトが表示されたら、請求機能を有効にします。
- プロンプトが表示されたら、API の利用規約に同意します。
認証情報を生成する
ディスプレイ＆ビデオ 360 API へのすべてのリクエストは認証を受ける必要があります。認証の概要については、Google に対してアプリケーションを認証および識別する方法をご覧ください。
以下の手順に沿って、OAuth 2.0 クライアント ID を作成します。この ID はインストール型アプリケーションのフローで使用します。サービス アカウントのフローで使用する認証情報の生成手順については、サービス アカウントのガイドをご覧ください。
手順に沿って Google API Console プロジェクトを設定します。
- API コンソールで [認証情報] ページを開きます。
[認証情報を作成] > [OAuth クライアント ID] をクリックします。
プロンプトが表示されたら、最も該当するアプリケーションの種類を選択します。このガイドで提供されている Java と Python のコード スニペットはデスクトップ アプリを前提としていますが、PHP のコード スニペットはウェブ アプリケーションを前提としています。
必要な追加情報を入力します。
- 初めてクライアント ID を作成する場合は、アプリケーション タイプを選択できるほか、[同意画面を設定] ボタンをクリックして独自の同意画面を設定することもできます。最初に同意画面を設定すると、その後設定を求められることはなくなります。この情報はいつでも更新できます。
[作成] をクリックします。
手順を完了すると、OAuth 2.0 クライアント ID とクライアント シークレットが表示されます。これらを JSON 形式でダウンロードして保存しておけば、後で使用できます。
ユーザーの同意画面を設定する
OAuth 2.0 を認証に使用すると、アプリケーションのユーザーはユーザー同意画面で提示される利用規約に同意した後に認証されます。
次の手順で、プロジェクトの同意画面を設定します。
- Google API Console で [同意画面] ページを開きます。プロンプトが表示されたら、プロジェクトのいずれかを選択するか、新しいプロジェクトを作成します。
- フォームに記入して [保存] をクリックします。