よくある質問

全般

API の最新バージョンは何ですか？

このドキュメントで扱っている API の最新バージョンは v1beta2 です。 このバージョンは、Trusted Tester 向けの限定公開ベータ版リリースです。

API にアクセスできるのは誰ですか？

v1beta2 アクセスは、許可リストに登録された Google API Console プロジェクトでのみ使用できます。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

一般公開されている Python 用 Google API クライアント ライブラリを使用してこの 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)