Package google.ads.dai.v1

インデックス

PartnerDiscoveryService

DAI への取り込みとクリエイティブの YouTube へのアップロードを管理します。

CreateCreative

rpc CreateCreative(CreateCreativeRequest) returns (Operation)

クリエイティブを作成します。正常に完了すると response フィールドにクリエイティブが返され、失敗すると google.rpc.Code が返されます。取り込みのステータスが metadata フィールドに含まれる CreateCreativeOperationMetadata を返します。
DeleteCreative

rpc DeleteCreative(DeleteCreativeRequest) returns (Empty)

クリエイティブを削除します。
GetCreative

rpc GetCreative(GetCreativeRequest) returns (Creative)

クリエイティブを取得します。

CreateCreativeOperationMetadata

CreateCreative から返された長時間実行オペレーションのメタデータ。metadata として表示します。

フィールド
creative_url

string

取り込みに使用されたクリエイティブの URL。これは、リクエストで指定されたプロパティに基づいて選択された、選択されたメザニン URL またはメディア レンディション URL です。
gv_registry_id

string

動画クリエイティブの一意の識別子（取り込みが成功した場合）。クリエイティブ リソースの名前は creatives/gv_registry_id です。
create_time

Timestamp

取り込みリクエストが作成された時刻。
youtube_status

IngestionStatus

現在の YouTube 取り込みステータス。

CreateCreativeRequest

PartnerDiscoveryService.CreateCreative のリクエスト。

フィールド
creative

Creative

取り込むクリエイティブ。
dynamic_creative_info

DynamicCreativeInfo

ダイナミック クリエイティブに関する情報。取り込むクリエイティブが動的である場合に必須です。

クリエイティブ

クリエイティブ リソース。PartnerDiscoveryService.CreateCreative の完了時に response として表示します。

フィールド
name

string

出力専用。クリエイティブ リソースの一意の名前（Google 動画 ID）。形式は creatives/id です。
advertiser

string

このクリエイティブに掲載される広告主の名前。
ad_system

string

必須。取り込みリクエストを生成する広告システムの名前。
ad_title

string

広告のタイトル。
ad_description

string

広告の説明。
mezzanines[]

MediaFile

広告のメザニン ファイルの URL とそのプロパティ。mezannines または media_files の少なくとも 1 つは必須です。
media_files[]

MediaFile

広告のメディア ファイルの URL とそのプロパティ。mezannines または media_files の少なくとも 1 つは必須です。
network_code

string

省略可。クリエイティブの対象となるパブリッシャーの Google アド マネージャー ネットワーク コード。クリエイティブが動的で、CreateCreativeRequest に DynamicCreativeInfo が入力されている場合に必須です。

DeleteCreativeRequest

PartnerDiscoveryService.DeleteCreative のリクエスト。

フィールド
name

string

削除するクリエイティブの Google 動画 ID。

DynamicCreativeInfo

動的クリエイティブが VCL 処理を行うために必要な情報。

フィールド
dynamic_group_id

string

クリエイティブのコア動画広告を表す ID。同じ動的グループ ID のダイナミック クリエイティブはすべて、コンテンツは同じで、ダイナミックな要素が異なると見なされます。
active_duration

Duration

このクリエイティブが有効で使用されていると見なされる期間。この期間が経過すると、動画クリエイティブ リポジトリでクリエイティブの削除がスケジュールされます。期間は 180 日間に制限されます。このフィールドを指定しない場合は、デフォルトの期間である 30 日が適用されます。

FailureReason

クリエイティブの取り込みに失敗した理由。

フィールド
reason

Reason

クリエイティブの取り込みエラーの説明。
code

int32

理由が DOWNLOAD_ERROR の場合の失敗の HTTP ステータス コード。

理由

クリエイティブの取り込みに失敗する原因として考えられる理由。

列挙型
REASON_UNSPECIFIED デフォルト値。
DOWNLOAD_ERROR HTTP ダウンロードに失敗しました。
INTERNAL_ERROR 内部エラーです。
INVALID_MEDIA 無効なメディア。

GetCreativeRequest

PartnerDiscoveryService.GetCreative のリクエスト。

フィールド
name

string

クリエイティブの Google 動画 ID。

IngestionStatus

クリエイティブ作成リクエストの取り込みステータス。

フィールド
state

State

動画クリエイティブの現在の取り込みステータス。
failure_reason

FailureReason

クリエイティブの取り込みに失敗した理由（取り込みに失敗した場合）。
update_time

Timestamp

取り込みジョブが最後に更新された時刻。

州

取り込み状態。

列挙型
STATE_UNSPECIFIED デフォルト値。
PROCESSING 動画クリエイティブは処理中です。
SUCCESS 動画クリエイティブの処理が正常に完了しました。
FAILURE 動画クリエイティブを取り込めませんでした。FailureReason をご覧ください。

MediaFile

特定のメディア ファイルに関連するプロパティ。

フィールド
uri

string

必須。クリエイティブのメディア ファイルへの一意の URL。
delivery

Delivery

必須。クリエイティブの配信タイプ。
height

int32

動画ファイルのネイティブの高さ（ピクセル単位）。
width

int32

動画ファイルのネイティブ幅（ピクセル単位）。
mime_type

string

必須。ファイル コンテナの MIME タイプ。一般的な MIME タイプには、Flash Video の「video/x-flv」や MP4 の「video/mp4」などがあります。
min_bitrate

int32

メディア ファイルの最小ビットレート。プログレッシブ ロード動画の場合は、この値を平均ビットレートにする必要があります。
max_bitrate

int32

メディア ファイルの最大ビットレート。プログレッシブ ロード動画の場合は、この値を平均ビットレートにする必要があります。

配信

配信タイプ。

列挙型
DELIVERY_UNSPECIFIED デフォルトの配信値。
DELIVERY_PROGRESSIVE プログレッシブ動画配信。
DELIVERY_STREAMING ストリーミング動画配信。