- リソース: AdGroupAd
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- DisplayVideoSourceAd
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- MastheadAd
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- YoutubeVideoDetails
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- VideoUnavailableReason
- VideoAspectRatio
- InStreamAd
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- CommonInStreamAttribute
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- ImageAsset
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- NonSkippableAd
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- BumperAd
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- AudioAd
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- VideoDiscoveryAd
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- サムネイル
- VideoPerformanceAd
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- AdUrl
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表現
- AdUrlType
- メソッド
リソース: AdGroupAd
1 つの広告グループに関連付けられた 1 つの広告。
JSON 表現 |
---|
{ "name": string, "advertiserId": string, "adGroupAdId": string, "adGroupId": string, "displayName": string, "entityStatus": enum ( |
フィールド | |
---|---|
name |
広告のリソース名。 |
advertiserId |
広告が属する広告主の一意の ID。 |
adGroupAdId |
広告の一意の ID。システムによって割り当てられます。 |
adGroupId |
広告が属する広告グループの一意の ID。 |
displayName |
広告の表示名。 UTF-8 でエンコードして最大サイズ 255 バイトにする必要があります。 |
entityStatus |
広告のエンティティ ステータス。 |
adUrls[] |
広告で使用される URL のリスト。 |
共用体フィールド ad_details 。広告の詳細。ad_details は次のいずれかになります。 |
|
displayVideoSourceAd |
ディスプレイから提供される広告の詳細と、Video 360 クリエイティブ。 |
mastheadAd |
|
inStreamAd |
5 秒後にスキップ可能なインストリーム広告の詳細。ブランド認知度またはリーチのマーケティング目標に使用されます。 |
nonSkippableAd |
リーチのマーケティング目標に使用されるスキップ不可の短いインストリーム動画広告の詳細(6 ~ 15 秒)。 |
bumperAd |
6 秒以下のスキップ不可の短い動画広告の詳細で、リーチに使用されます。 |
audioAd |
リーチのマーケティング目標に使用するオーディオ広告の詳細。 |
videoDiscoverAd |
ユーザーが発見した場所に表示される動画を宣伝する広告の詳細。 |
videoPerformanceAd |
ビジネス、サービス、商品へのアクションを促すために動画アクション キャンペーンで使われている広告の詳細。 |
DisplayVideoSourceAd
ディスプレイ&ビデオ 360 のクリエイティブから生成された広告。
JSON 表現 |
---|
{ "creativeId": string } |
フィールド | |
---|---|
creativeId |
ソース クリエイティブの ID。 |
MastheadAd
マストヘッド広告の詳細。
JSON 表現 |
---|
{ "video": { object ( |
フィールド | |
---|---|
video |
広告で使用される YouTube 動画。 |
headline |
広告の見出しです。 |
description |
広告の説明です。 |
videoAspectRatio |
マストヘッドで自動再生される YouTube 動画のアスペクト比。 |
autoplayVideoStartMillisecond |
動画の再生が開始されるまでの時間(ミリ秒単位)。 |
autoplayVideoDuration |
動画が自動再生される時間。
|
callToActionButtonLabel |
行動を促すフレーズのボタンのテキスト。 |
callToActionFinalUrl |
行動を促すフレーズのボタンのリンク先 URL。 |
callToActionTrackingUrl |
行動を促すフレーズのボタンのトラッキング URL。 |
showChannelArt |
YouTube ページの上部に背景またはバナーを表示するかどうかを指定します。 |
companionYoutubeVideos[] |
パソコンでマストヘッド広告の横に表示される動画。2 個以下の値を指定してください。 |
YoutubeVideoDetails
YouTube 動画の詳細。
JSON 表現 |
---|
{
"id": string,
"unavailableReason": enum ( |
フィールド | |
---|---|
id |
YouTube ウェブページで検索できる YouTube 動画の ID。 |
unavailableReason |
動画データが利用できない理由。 |
VideoAspectRatio
YouTube 動画のアスペクト比。
列挙型 | |
---|---|
VIDEO_ASPECT_RATIO_UNSPECIFIED |
指定されていないか、不明です。 |
VIDEO_ASPECT_RATIO_WIDESCREEN |
動画が引き伸ばされ、上部と下部がトリミングされます。 |
VIDEO_ASPECT_RATIO_FIXED_16_9 |
動画のアスペクト比は固定 16:9 です。 |
InStreamAd
インストリーム広告の詳細。
JSON 表現 |
---|
{
"commonInStreamAttribute": {
object ( |
フィールド | |
---|---|
commonInStreamAttribute |
一般的な広告属性。 |
customParameters |
トラッキング URL テンプレートにカスタム値を渡すカスタム パラメータ。
|
CommonInStreamAttribute
インストリーム広告、スキップ不可の広告、バンパー広告の一般的な属性。
JSON 表現 |
---|
{ "displayUrl": string, "finalUrl": string, "trackingUrl": string, "actionButtonLabel": string, "actionHeadline": string, "video": { object ( |
フィールド | |
---|---|
displayUrl |
広告とともに表示されるウェブページのアドレス。 |
finalUrl |
広告をクリックしたユーザーに表示されるウェブページの URL アドレス。 |
trackingUrl |
トラッキングのためにバックグラウンドで読み込まれる URL アドレス。 |
actionButtonLabel |
行動を促すフレーズのボタンのテキスト。 |
actionHeadline |
行動を促すフレーズのバナーの見出し。 |
video |
広告の YouTube 動画。 |
companionBanner |
動画広告の横に表示される画像。 |
ImageAsset
画像アセットのメタデータ。
JSON 表現 |
---|
{
"mimeType": string,
"fullSize": {
object ( |
フィールド | |
---|---|
mimeType |
画像アセットの MIME タイプ。 |
fullSize |
元のサイズでこの画像のメタデータ。 |
fileSize |
画像アセットのファイルサイズ(バイト単位)。 |
NonSkippableAd
スキップ不可の広告の詳細。
JSON 表現 |
---|
{
"commonInStreamAttribute": {
object ( |
フィールド | |
---|---|
commonInStreamAttribute |
一般的な広告属性。 |
customParameters |
トラッキング URL テンプレートにカスタム値を渡すカスタム パラメータ。
|
BumperAd
バンパー広告の詳細。
JSON 表現 |
---|
{
"commonInStreamAttribute": {
object ( |
フィールド | |
---|---|
commonInStreamAttribute |
一般的な広告属性。 |
AudioAd
オーディオ広告の詳細。
JSON 表現 |
---|
{
"displayUrl": string,
"finalUrl": string,
"trackingUrl": string,
"video": {
object ( |
フィールド | |
---|---|
displayUrl |
広告とともに表示されるウェブページのアドレス。 |
finalUrl |
広告をクリックしたユーザーに表示されるウェブページの URL アドレス。 |
trackingUrl |
トラッキングのためにバックグラウンドで読み込まれる URL アドレス。 |
video |
広告の YouTube 動画。 |
VideoDiscoveryAd
TrueView ディスカバリー広告の詳細です。
JSON 表現 |
---|
{ "headline": string, "description1": string, "description2": string, "video": { object ( |
フィールド | |
---|---|
headline |
広告の見出し。 |
description1 |
広告の最初のテキスト行。 |
description2 |
広告の 2 行目。 |
video |
広告が宣伝する YouTube 動画。 |
thumbnail |
広告で使用されているサムネイル画像。 |
サムネイル
TrueView ディスカバリー広告で使用可能なサムネイル オプション。
列挙型 | |
---|---|
THUMBNAIL_UNSPECIFIED |
不明または未指定。 |
THUMBNAIL_DEFAULT |
デフォルトのサムネイルは、自動生成またはユーザーがアップロードしたものになります。 |
THUMBNAIL_1 |
サムネイル 1、動画から生成されたもの。 |
THUMBNAIL_2 |
動画から生成されたサムネイル 2。 |
THUMBNAIL_3 |
サムネイル 3、動画から生成されたもの。 |
VideoPerformanceAd
動画パフォーマンス広告の詳細。
JSON 表現 |
---|
{ "finalUrl": string, "trackingUrl": string, "actionButtonLabels": [ string ], "headlines": [ string ], "longHeadlines": [ string ], "descriptions": [ string ], "displayUrlBreadcrumb1": string, "displayUrlBreadcrumb2": string, "domain": string, "videos": [ { object ( |
フィールド | |
---|---|
finalUrl |
広告をクリックしたユーザーに表示されるウェブページの URL アドレス。 |
trackingUrl |
トラッキングのためにバックグラウンドで読み込まれる URL アドレス。 |
actionButtonLabels[] |
行動を促すフレーズのボタンに表示されるテキスト アセットのリスト。 |
headlines[] |
行動を促すフレーズのバナーに表示される広告見出しのリスト。 |
longHeadlines[] |
行動を促すフレーズのバナーに表示される単独の広告見出しのリスト。 |
descriptions[] |
行動を促すフレーズのバナーに表示される説明文のリスト。 |
displayUrlBreadcrumb1 |
表示 URL のドメインの後の最初の部分。 |
displayUrlBreadcrumb2 |
表示 URL のドメインの後の 2 番目の部分。 |
domain |
表示 URL のドメイン。 |
videos[] |
この広告で使用されている YouTube 動画アセットのリスト。 |
customParameters |
トラッキング URL テンプレートにカスタム値を渡すカスタム パラメータ。
|
companionBanners[] |
この広告で使用されているコンパニオン バナーのリスト。 |
AdUrl
広告に関連する追加の URL(ビーコンなど)。
JSON 表現 |
---|
{
"type": enum ( |
フィールド | |
---|---|
type |
広告 URL のタイプ。 |
url |
URL 文字列の値。 |
AdUrlType
使用できる広告の URL タイプ。
列挙型 | |
---|---|
AD_URL_TYPE_UNSPECIFIED |
不明または未指定。 |
AD_URL_TYPE_BEACON_IMPRESSION |
クリエイティブのインプレッションが配信されたときに ping する 1×1 のトラッキング ピクセル。 |
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION |
エキスパンド DCM インプレッション ビーコン。サービング時には、複数のビーコンに展開されます。 |
AD_URL_TYPE_BEACON_CLICK |
クリック イベントがトリガーされたときに ping するトラッキング URL。 |
AD_URL_TYPE_BEACON_SKIP |
スキップ イベントがトリガーされたときに ping を実行するトラッキング URL。 |
メソッド |
|
---|---|
|
広告グループの広告を取得します。 |
|
広告グループの広告を一覧表示します。 |