ディスプレイ＆ビデオ 360 API SDF アップロードパイロット

このトライアルでは、ディスプレイ＆ビデオ 360 API を使用して構造化データファイル（SDF）をアップロードできる、新しいディスプレイ＆ビデオ 360 API ベータ版機能をテストできます。

このトライアルでは、登録された各 Google Cloud プロジェクトで、広告主ごとに 1 日最大 30 個の SDF をアップロードできます。各ファイルには、最大 10,000 個のエントリを含めることができます。

試験運用版の機能の使用方法については、SDF をアップロードするガイドをご覧ください。

使ってみる

ディスプレイ＆ビデオ 360 API の利用を開始したら、次の手順を完了して試験運用機能を使用します。

Google Cloud プロジェクトをパイロットに登録する

パイロット版へのアクセスをリクエストして承認されたお客様のみが、パイロット版の機能を使用できます。

パイロット機能を使用する前に、Google Cloud プロジェクト ID がパイロットに登録されていることを Google の営業担当者に確認してください。

API キーを生成する

標準のディスプレイ＆ビデオ 360 API 認証情報に加えて、API キーを使用する必要があります。クライアント構成で使用する Google Cloud プロジェクトの API キーを生成します。

クライアントを構成する

これらのパイロット機能にアクセスするには、Python 用 Google API クライアントライブラリを使用します。

パイロット機能にリクエストを行うようにクライアントライブラリをインストールして構成する方法は次のとおりです。

Python

google-api-python-client をインストールする
```
pip install --upgrade google-api-python-client
```

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

from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient import discovery

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

注: この手順を初めて行う際には、認証を求めるメッセージがブラウザに表示されます。承認する前に、ディスプレイ＆ビデオ 360 へのアクセス権を持つ Google アカウントでログインしていることをご確認ください。ログインしているアカウントに代わって、アプリがデータにアクセスすることが認証されます。ディスプレイ＆ビデオ 360 のユーザー権限について詳しくは、リクエストの承認ガイドをご覧ください。
```
# Set up a flow object to create the credentials using the
# client secrets file and OAuth scopes.
credentials = InstalledAppFlow.from_client_secrets_file(
    path-to-client-secrets-file,
    oauth-scopes).run_local_server()
```

ディスカバリサービスを使用して、承認済みサービスオブジェクトを作成します。

api_key = "API_KEY"
api_name = "displayvideo"
api_url = f"https://{api_name}.googleapis.com"
api_version = "v4"
api_label = "SDF_UPLOAD_ALPHA"

discovery_url = (
    f"{api_url}/$discovery/rest?key={api_key}&version={api_version}&labels={api_label}"
)

service = discovery.build(api_name, api_version,
                          discoveryServiceUrl=discovery_url,
                          credentials=credentials)

SDF のアップロードを開始する

機能ガイドの手順に沿って、構造化データファイルのアップロードを開始します。