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 の利用規約に同意します。
認証情報を生成する
Display & Video 360 API へのリクエストはすべて承認を受ける必要があります。承認の概要については、Google に対してアプリケーションを認可および識別する方法をご覧ください。
次の手順では、インストール型アプリケーションのフローで使用する OAuth 2.0 クライアント ID を作成する方法を説明します。サービス アカウントのフローで使用する認証情報の生成手順については、サービス アカウントのガイドをご覧ください。
手順に沿って Google API Console プロジェクトを構成します。
- API コンソールで [認証情報] ページを開きます。
[認証情報を作成] > [OAuth クライアント ID] をクリックします。
プロンプトが表示されたら、最も適切なアプリケーションの種類を選択します。以下のガイドに記載されている Java と Python のコード スニペットはデスクトップ アプリを前提としていますが、PHP のコード スニペットはウェブ アプリケーションを前提としています。
その他の必須情報を入力します。
- クライアント ID を初めて作成する場合は、アプリケーション タイプを選択できるだけでなく、[同意画面を構成] ボタンをクリックして同意画面を構成できます。最初に同意画面を設定すると、設定を求めるプロンプトが再度表示されることはありませんが、この情報はいつでも更新できます。
[作成] をクリックします。
完了すると、OAuth 2.0 のクライアント ID とクライアント シークレットが表示されます。これらを JSON 形式でダウンロードして、後で使用するために保存できます。
ユーザーの同意画面を設定する
認証に OAuth 2.0 を使用する場合、ユーザーはユーザーの同意画面で提示された利用規約に同意すると認証されます。
次の手順で、プロジェクトの同意画面を設定します。
- Google API Console で [同意画面] ページを開きます。プロンプトが表示されたら、プロジェクトを選択するか、新しいプロジェクトを作成します。
- フォームに記入して [保存] をクリックします。