よくある質問

全般

API の最新バージョンを教えてください。

このドキュメントで対応している API の最新バージョンは v1beta2 です。このバージョンは、Trusted Tester のみを対象に利用できる限定公開ベータ版です。

API にアクセスできるのはどのユーザーですか?

v1beta2 アクセスは、許可リストに登録された Google API コンソール プロジェクトでのみ使用できます。API ドキュメントへのアクセスは、個別のユーザーの許可リストによって管理されます。

コンソール プロジェクトが許可リストに登録されているかどうかを確認するにはどうすればよいですか?

以下の URL の API_KEY 要素をクリックして、プロジェクトから API キーを選択します。選択したプロジェクトに API キーが存在しない場合は、作成するよう求められます。完了したら、表示された URL をコピーしてブラウザに貼り付けます。

https://displayvideo.googleapis.com/$discovery/rest?version=v1beta2&labels=V1BETA2_TRUSTED_TESTER&key=API_KEY

API の記述が JSON の場合、プロジェクトは許可リストに登録されています。エラーが表示される場合は、プロジェクトが許可リストに登録されていません。

API の使用

API へのアクセスに使用する URL

https://displayvideo.googleapis.com

どのような認証方法がサポートされていますか?

サポートされている認証方法は OAuth 2.0 のみです。すべてのリクエストは、次のスコープに対して承認される必要があります。

  • https://www.googleapis.com/auth/display-video

コードを記述したい。クライアント ライブラリの場所

Python

この API には、一般公開されている Python 用 Google API クライアント ライブラリを使用してアクセスできます。ライブラリをインストールして承認済みサービス オブジェクトを作成する手順は次のとおりです。

  1. google-api-python-client をインストールする

    pip install --upgrade google-api-python-client
    
  2. 承認済みの credentials オブジェクトを取得します。例については、アプリケーションの設定に関するガイドをご覧ください。

  3. 検出サービスを使用して、承認済みサービス オブジェクトを作成します。

    api_key = 'API_KEY'
    api_name = 'displayvideo'
    api_url = 'https://%s.googleapis.com/' % api_name
    api_version = 'v1beta2'
    
    discovery_url = (
        '%s/$discovery/rest?key=%s&version=%s&labels=%s'
        % (api_url, api_key, api_version, 'V1BETA2_TRUSTED_TESTER')
    )
    
    service = discovery.build(api_name, api_version,
                              discoveryServiceUrl=discovery_url,
                              http=credentials)