REST Resource: advertisers.adGroupAds

リソース: AdGroupAd

広告グループに関連付けられた 1 つの広告。

JSON 表現 
{
  "name": string,
  "advertiserId": string,
  "adGroupAdId": string,
  "adGroupId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "adUrls": [
    {
      object (AdUrl)
    }
  ],

  // Union field ad_details can be only one of the following:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  }
  // End of list of possible types for union field ad_details.
}
フィールド
name

string

広告のリソース名。
advertiserId

string (int64 format)

広告が属する広告主の一意の ID。
adGroupAdId

string (int64 format)

広告の一意の ID。システムによって割り当てられます。
adGroupId

string (int64 format)

広告が属する広告グループの一意の ID。
displayName

string

広告の表示名。

UTF-8 でエンコードし、最大サイズを 255 バイトにする必要があります。
entityStatus

enum (EntityStatus)

広告のエンティティ ステータス。
adUrls[]

object (AdUrl)

広告で使用される URL のリスト。
共用体フィールド ad_details。広告の詳細。ad_details は次のいずれかになります。
displayVideoSourceAd

object (DisplayVideoSourceAd)

ディスプレイ＆ビデオ 360 のクリエイティブから取得した広告の詳細。
mastheadAd

object (MastheadAd)

YouTube ホームフィードに表示された広告の詳細。
inStreamAd

object (InStreamAd)

ブランド認知度またはリーチのマーケティング目標に使用される、5 秒後にスキップ可能なインストリーム広告の詳細。
nonSkippableAd

object (NonSkippableAd)

リーチのマーケティング目標に使用される、6 ～ 15 秒のスキップ不可の短いインストリーム動画広告の詳細。
bumperAd

object (BumperAd)

リーチに使用される 6 秒以下のスキップ不可の短い動画広告の詳細。
audioAd

object (AudioAd)

リーチのマーケティング目標に使用されるオーディオ広告の詳細。
videoDiscoverAd

object (VideoDiscoveryAd)

ファインド面に表示される動画を宣伝する広告の詳細。
videoPerformanceAd

object (VideoPerformanceAd)

ビジネス、サービス、商品に対するユーザー行動を促進するために動画アクション キャンペーンで使用される広告の詳細。

DisplayVideoSourceAd

ディスプレイ＆ビデオ 360 のクリエイティブから取得された広告。

JSON 表現 
{
  "creativeId": string
}
フィールド
creativeId

string (int64 format)

移行元のクリエイティブの ID。

MastheadAd

マストヘッド広告の詳細。

JSON 表現 
{
  "video": {
    object (YoutubeVideoDetails)
  },
  "headline": string,
  "description": string,
  "videoAspectRatio": enum (VideoAspectRatio),
  "autoplayVideoStartMillisecond": string,
  "autoplayVideoDuration": string,
  "callToActionButtonLabel": string,
  "callToActionFinalUrl": string,
  "callToActionTrackingUrl": string,
  "showChannelArt": boolean,
  "companionYoutubeVideos": [
    {
      object (YoutubeVideoDetails)
    }
  ]
}
フィールド
video

object (YoutubeVideoDetails)

広告で使用されている YouTube 動画。
headline

string

広告の見出しです。
description

string

広告の説明。
videoAspectRatio

enum (VideoAspectRatio)

マストヘッドで自動再生される YouTube 動画のアスペクト比。
autoplayVideoStartMillisecond

string (int64 format)

動画の再生が開始されるまでの時間（ミリ秒単位）。
autoplayVideoDuration

string (Duration format)

動画が自動再生される時間。

s で終わる小数点以下 9 桁までの秒単位の期間。例: "3.5s"。
callToActionButtonLabel

string

行動を促すフレーズのボタンに表示されるテキスト。
callToActionFinalUrl

string

行動を促すフレーズのボタンのリンク先 URL。
callToActionTrackingUrl

string

行動を促すフレーズのボタンのトラッキング URL。
showChannelArt

boolean

YouTube ページの上部に表示される背景またはバナーを表示するかどうか。
companionYoutubeVideos[]

object (YoutubeVideoDetails)

パソコン上でマストヘッド広告の横に表示される動画です。2 つ以下にしてください。

YoutubeVideoDetails

YouTube 動画の詳細。

JSON 表現 
{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason)
}
フィールド
id

string

YouTube ウェブページで検索できる YouTube 動画 ID。
unavailableReason

enum (VideoUnavailableReason)

動画データが利用できない理由。

VideoUnavailableReason

動画が利用できない理由として考えられるもの。

列挙型
VIDEO_UNAVAILABLE_REASON_UNSPECIFIED 不明または未指定。
VIDEO_UNAVAILABLE_REASON_PRIVATE この動画は非公開です。
VIDEO_UNAVAILABLE_REASON_DELETED 動画が削除されます。

VideoAspectRatio

YouTube 動画のアスペクト比の候補。

列挙型
VIDEO_ASPECT_RATIO_UNSPECIFIED 指定されていないか不明。
VIDEO_ASPECT_RATIO_WIDESCREEN 動画が引き伸ばされ、上下が切り取られています。
VIDEO_ASPECT_RATIO_FIXED_16_9 動画は固定のアスペクト比 16:9 を使用します。

InStreamAd

インストリーム広告の詳細。

JSON 表現 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
フィールド
commonInStreamAttribute

object (CommonInStreamAttribute)

一般的な広告の属性。
customParameters

map (key: string, value: string)

トラッキング URL テンプレートにカスタム値を渡すためのカスタム パラメータ。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }

CommonInStreamAttribute

インストリーム広告、スキップ不可の広告、バンパー広告の共通属性。

JSON 表現 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}
フィールド
displayUrl

string

広告に表示されるウェブページのアドレスです。
finalUrl

string

広告をクリックしたユーザーに表示されるウェブページの URL アドレスです。
trackingUrl

string

トラッキングの目的でバックグラウンドで読み込まれる URL アドレス。
actionButtonLabel

string

行動を促すフレーズのボタンに表示されるテキスト。
actionHeadline

string

行動を促すフレーズのバナーの広告見出し。
video

object (YoutubeVideoDetails)

広告の YouTube 動画。
companionBanner

object (ImageAsset)

動画広告の横に表示される画像。

ImageAsset

画像アセットのメタデータ。

JSON 表現 
{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string
}
フィールド
mimeType

string

画像アセットの MIME タイプ。
fullSize

object (Dimensions)

元のサイズの画像のメタデータ。
fileSize

string (int64 format)

画像アセットのファイルサイズ（バイト単位）。

NonSkippableAd

スキップ不可の広告の詳細。

JSON 表現 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
フィールド
commonInStreamAttribute

object (CommonInStreamAttribute)

一般的な広告の属性。
customParameters

map (key: string, value: string)

トラッキング URL テンプレートにカスタム値を渡すためのカスタム パラメータ。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }

BumperAd

バンパー広告の詳細。

JSON 表現 
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}
フィールド
commonInStreamAttribute

object (CommonInStreamAttribute)

一般的な広告の属性。

AudioAd

オーディオ広告の詳細。

JSON 表現 
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}
フィールド
displayUrl

string

広告に表示されるウェブページのアドレスです。
finalUrl

string

広告をクリックしたユーザーに表示されるウェブページの URL アドレスです。
trackingUrl

string

トラッキングの目的でバックグラウンドで読み込まれる URL アドレス。
video

object (YoutubeVideoDetails)

広告の YouTube 動画。

VideoDiscoveryAd

TrueView ディスカバリー広告の詳細。

JSON 表現 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}
フィールド
headline

string

広告の見出し。
description1

string

広告の 1 行目のテキスト。
description2

string

広告の 2 行目のテキスト。
video

object (YoutubeVideoDetails)

広告で宣伝する YouTube 動画。
thumbnail

enum (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 (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanners": [
    {
      object (ImageAsset)
    }
  ]
}
フィールド
finalUrl

string

広告をクリックしたユーザーに表示されるウェブページの URL アドレスです。
trackingUrl

string

トラッキングの目的でバックグラウンドで読み込まれる URL アドレス。
actionButtonLabels[]

string

行動を促すフレーズのボタンに表示されるテキスト アセットのリスト。
headlines[]

string

行動を促すフレーズのバナーに表示される見出しのリスト。
longHeadlines[]

string

行動を促すフレーズのバナーに表示される単独の広告見出しのリスト。
descriptions[]

string

行動を促すフレーズのバナーに表示される説明のリスト。
displayUrlBreadcrumb1

string

表示 URL のドメインの後の最初の部分。
displayUrlBreadcrumb2

string

表示 URL のドメインの後に続く 2 番目の部分。
domain

string

表示 URL のドメイン。
videos[]

object (YoutubeVideoDetails)

この広告で使用されている YouTube 動画アセットのリスト。
customParameters

map (key: string, value: string)

トラッキング URL テンプレートにカスタム値を渡すためのカスタム パラメータ。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }
companionBanners[]

object (ImageAsset)

この広告で使用されるコンパニオン バナーのリスト。

AdUrl

ビーコンなど、広告に関連する追加の URL。

JSON 表現 
{
  "type": enum (AdUrlType),
  "url": string
}
フィールド
type

enum (AdUrlType)

広告 URL のタイプ。
url

string

URL 文字列値。

AdUrlType

広告 URL の種類。

列挙型
AD_URL_TYPE_UNSPECIFIED 不明または未指定。
AD_URL_TYPE_BEACON_IMPRESSION クリエイティブのインプレッションが配信されたときに ping を送信する 1x1 トラッキング ピクセル。
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION DCM エキスパンド インプレッション ビーコン。配信時に、複数のビーコンに展開されます。
AD_URL_TYPE_BEACON_CLICK クリック イベントがトリガーされたときに ping を送信するトラッキング URL。
AD_URL_TYPE_BEACON_SKIP スキップ イベントがトリガーされたときに ping を送信するトラッキング URL。

メソッド

get

 広告グループの広告を取得します。

list

 広告グループ広告を一覧表示します。