REST Resource: advertisers.youtubeAdGroupAds

{
  "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.
}

string

広告のリソース名。

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string

広告の表示名。

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

enum (EntityStatus)

広告のエンティティ ステータス。

object (AdUrl)

広告で使用される URL のリスト。

object (DisplayVideoSourceAd)

ディスプレイから提供される広告の詳細と、Video 360 クリエイティブ。

object (MastheadAd)

YouTube ホームフィードで配信される広告の詳細。

object (InStreamAd)

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

object (NonSkippableAd)

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

object (BumperAd)

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

object (AudioAd)

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

object (VideoDiscoveryAd)

ユーザーが発見した場所に表示される動画を宣伝する広告の詳細。

object (VideoPerformanceAd)

ビジネス、サービス、商品へのアクションを促すために動画アクション キャンペーンで使われている広告の詳細。

{
  "creativeId": string
}

string (int64 format)

ソース クリエイティブの ID。

{
  "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)
    }
  ]
}

object (YoutubeVideoDetails)

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

string

広告の見出しです。

string

広告の説明です。

enum (VideoAspectRatio)

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

string (int64 format)

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

string (Duration format)

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

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

string

行動を促すフレーズのボタンのテキスト。

string

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

string

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

boolean

YouTube ページの上部に背景またはバナーを表示するかどうかを指定します。

object (YoutubeVideoDetails)

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

{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason)
}

string

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

enum (VideoUnavailableReason)

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

{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}

object (CommonInStreamAttribute)

一般的な広告属性。

map (key: string, value: string)

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

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

{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}

string

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

string

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

string

トラッキングのためにバックグラウンドで読み込まれる URL アドレス。

string

行動を促すフレーズのボタンのテキスト。

string

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

object (YoutubeVideoDetails)

広告の YouTube 動画。

object (ImageAsset)

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

{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string
}

string

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

object (Dimensions)

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

string (int64 format)

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

{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}

object (CommonInStreamAttribute)

一般的な広告属性。

map (key: string, value: string)

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

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

{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}

object (CommonInStreamAttribute)

一般的な広告属性。

{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}

string

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

string

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

string

トラッキングのためにバックグラウンドで読み込まれる URL アドレス。

object (YoutubeVideoDetails)

広告の YouTube 動画。

{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}

string

広告の見出し。

string

広告の最初のテキスト行。

string

広告の 2 行目。

object (YoutubeVideoDetails)

広告が宣伝する YouTube 動画。

enum (Thumbnail)

広告で使用されているサムネイル画像。

{
  "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)
    }
  ]
}

string

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

string

トラッキングのためにバックグラウンドで読み込まれる URL アドレス。

string

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

string

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

string

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

string

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

string

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

string

表示 URL のドメインの後の 2 番目の部分。

string

表示 URL のドメイン。

object (YoutubeVideoDetails)

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

map (key: string, value: string)

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

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

object (ImageAsset)

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

{
  "type": enum (AdUrlType),
  "url": string
}

enum (AdUrlType)

広告 URL のタイプ。

string

URL 文字列の値。