REST Resource: advertisers.adGroupAds

リソース: AdGroupAd

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

JSON 表現 
{
  "name": string,
  "advertiserId": string,
  "adGroupAdId": string,
  "adGroupId": string,
  "displayName": string,
  "adPolicy": {
    object (AdPolicy)
  },
  "entityStatus": enum (EntityStatus),
  "adUrls": [
    {
      object (AdUrl)
    }
  ],
  "dcmTrackingInfo": {
    object (DcmTrackingInfo)
  },
  "containsSyntheticMedia": boolean,
  "parentCreativeId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  },
  "demandGenVideoAd": {
    object (DemandGenVideoAd)
  },
  "demandGenImageAd": {
    object (DemandGenImageAd)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAd)
  },
  "demandGenProductAd": {
    object (DemandGenProductAd)
  }
  // End of mutually exclusive fields.
}
フィールド
name

string

出力専用。広告のリソース名。
advertiserId

string (int64 format)

出力専用。広告が属する広告主の一意の ID。
adGroupAdId

string (int64 format)

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

string (int64 format)

必須。変更不可。広告が属する広告グループの一意の ID。
displayName

string

必須。広告の表示名。

UTF-8 でエンコードされ、最大サイズが 255 バイトである必要があります。
adPolicy

object (AdPolicy)

出力専用。広告のポリシー承認状況。
entityStatus

enum (EntityStatus)

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

object (AdUrl)

出力専用。広告で使用されている URL のリスト。
dcmTrackingInfo

object (DcmTrackingInfo)

省略可。DCM トラッキング広告の情報。

DCM トラッキング広告の情報を削除するには、このフィールドを空欄にしてください。
containsSyntheticMedia

boolean

省略可。広告に改変または合成されたメディアが含まれているかどうかを示します。

選挙広告の確認済み広告主様が作成した広告にのみ設定する必要があります。YouTube 広告にのみ有効です。
parentCreativeId

string (int64 format)

出力専用。この広告の生成に使用されたディスプレイ＆ビデオ 360 クリエイティブの ID。

このフィールドは、親広告グループに割り当てられたクリエイティブの割り当てから生成された広告に対してのみ入力されます。
広告の詳細。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
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)

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

object (DemandGenVideoAd)

省略可。デマンド ジェネレーション動画広告の詳細。
demandGenImageAd

object (DemandGenImageAd)

省略可。デマンド ジェネレーション イメージ広告の詳細。
demandGenProductAd

object (DemandGenProductAd)

省略可。デマンド ジェネレーション商品広告の詳細。
相互に排他的なフィールドの終了。

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),
  "videoAssetId": string
}
フィールド
id

string

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

enum (VideoUnavailableReason)

出力専用。動画データが利用できない理由。
videoAssetId

string (int64 format)

必須。YouTube 動画アセット ID。これは AdAsset リソースの adAssetId です。

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,
  "userSpecifiedTrackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}
フィールド
displayUrl

string

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

string

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

string

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

v4 以前では、このフィールドはユーザーが手動で指定したトラッキング URL を表します。これは v5 の userSpecifiedTrackingUrl にあります。
userSpecifiedTrackingUrl

string

省略可。ユーザーが手動で指定したトラッキング URL。
actionButtonLabel

string

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

actionHeadline が設定されている場合は、設定する必要があります。
actionHeadline

string

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

object (YoutubeVideoDetails)

必須。変更不可。広告の YouTube 動画。
companionBanner

object (ImageAsset)

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

ImageAsset

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

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

string

出力専用。画像アセットの MIME タイプ。
fullSize

object (Dimensions)

出力専用。この画像の元のサイズのメタデータ。
fileSize

string (int64 format)

出力専用。画像アセットのファイルサイズ（バイト単位）。
assetId

string (int64 format)

必須。アセットの一意の ID。

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,
  "userSpecifiedTrackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}
フィールド
displayUrl

string

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

string

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

string

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

v4 以前では、このフィールドはユーザーが手動で指定したトラッキング URL を表します。これは v5 の userSpecifiedTrackingUrl にあります。
userSpecifiedTrackingUrl

string

省略可。ユーザーが手動で指定したトラッキング URL。
video

object (YoutubeVideoDetails)

広告の YouTube 動画。

VideoDiscoveryAd

動画ファインド広告の詳細。

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)

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

サムネイル

動画ファインド広告で使用できるサムネイルのオプション。

列挙型
THUMBNAIL_UNSPECIFIED 不明または未指定。
THUMBNAIL_DEFAULT デフォルトのサムネイル。自動生成されたものか、ユーザーがアップロードしたものです。
THUMBNAIL_1 サムネイル 1。動画から生成されたもの。
THUMBNAIL_2 サムネイル 2。動画から生成されたもの。
THUMBNAIL_3 動画から生成されたサムネイル 3。

VideoPerformanceAd

動画パフォーマンス広告の詳細。

JSON 表現 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "actionButtonLabels": [
    string
  ],
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "domain": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanners": [
    {
      object (ImageAsset)
    }
  ],
  "businessName": string,
  "logo": {
    object (ImageAsset)
  }
}
フィールド
finalUrl

string

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

string

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

v4 以前では、このフィールドはユーザーが手動で指定したトラッキング URL を表します。これは v5 の userSpecifiedTrackingUrl にあります。
userSpecifiedTrackingUrl

string

省略可。ユーザーが手動で指定したトラッキング URL。
actionButtonLabels[]

string

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

headlines が設定されている場合は、設定する必要があります。
headlines[]

string

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

string

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

親広告申込情報の lineItemType が LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE の場合を除き、設定する必要があります。親広告申込情報の lineItemType が LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE の場合、このフィールドは設定できません。
descriptions[]

string

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

親広告申込情報の lineItemType が LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE の場合を除き、設定する必要があります。親広告申込情報の が の場合、このフィールドは設定できません。
displayUrlBreadcrumb1

string

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

string

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

displayUrlBreadcrumb1 も設定されている場合にのみ設定できます。
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)

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

string

省略可。広告に表示されるビジネスの名前。

この設定は、広告主単位でデフォルト値が設定されていない限り必須です。未設定のままにすると、デフォルト値が適用されます。

DemandGenVideoAd

デマンド ジェネレーション動画広告の詳細。

JSON 表現 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": enum (CallToAction),
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanner": {
    object (ImageAsset)
  },
  "logo": {
    object (ImageAsset)
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string
}
フィールド
finalUrl

string

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

string

出力専用。トラッキング目的でバックグラウンドで読み込まれる URL アドレス。
userSpecifiedTrackingUrl

string

省略可。ユーザーが手動で指定したトラッキング URL。
callToAction

enum (CallToAction)

必須。広告に表示される行動を促すフレーズのボタン。

サポートされている値は次のとおりです。

  • AUTOMATED
  • LEARN_MORE
  • GET_QUOTE
  • APPLY_NOW
  • SIGN_UP
  • CONTACT_US
  • SUBSCRIBE
  • DOWNLOAD
  • BOOK_NOW
  • SHOP_NOW
  • BUY_NOW
  • DONATE_NOW
  • ORDER_NOW
  • PLAY_NOW
  • SEE_MORE
  • START_NOW
  • VISIT_SITE
  • WATCH_NOW
headlines[]

string

必須。広告に表示される広告見出しのリスト。
longHeadlines[]

string

必須。広告に表示される長い広告見出しのリスト。
descriptions[]

string

必須。広告に表示される説明文のリスト。
displayUrlBreadcrumb1

string

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

string

省略可。表示 URL のドメインの後に続く 2 番目の部分。
videos[]

object (YoutubeVideoDetails)

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

map (key: string, value: string)

省略可。トラッキング URL に追加するカスタム パラメータと、それに対応する値。

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

object (ImageAsset)

省略可。この広告で使用されるコンパニオン バナー。
finalMobileUrl

string

省略可。モバイル デバイスで広告をクリックしたユーザーに表示されるウェブページの URL アドレスです。
finalUrlSuffix

string

省略可。ランディング ページ URL に追加する接尾辞。
businessName

string

省略可。広告に表示されるビジネスの名前。

広告主単位でデフォルト値が設定されていない限り、この設定は必須です。未設定のままにすると、デフォルト値が適用されます。

CallToAction

デマンド ジェネレーション商品広告/動画広告で使用できる行動を促すフレーズの値。

列挙型
CALL_TO_ACTION_UNSPECIFIED 指定されていないか、不明です。
AUTOMATED 自動システムによる連絡。
LEARN_MORE 詳細
GET_QUOTE 見積もりを依頼
APPLY_NOW 今すぐお申し込みください。
SIGN_UP 登録します。
CONTACT_US お問い合わせください。
SUBSCRIBE 登録] をタップします。
DOWNLOAD ダウンロード] をタップします。
BOOK_NOW 今すぐ予約
SHOP_NOW 今すぐ購入しよう。
BUY_NOW 今すぐ購入しよう。
DONATE_NOW 今すぐ寄付する。
ORDER_NOW 今すぐ注文
PLAY_NOW 今すぐプレイ。
SEE_MORE 詳細
START_NOW 今すぐお申し込みください。
VISIT_SITE サイトにアクセスします。
WATCH_NOW ぜひご覧ください。

DemandGenImageAd

デマンド ジェネレーション イメージ広告の詳細。

JSON 表現 
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": string,
  "headlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "customParameters": {
    string: string,
    ...
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string,
  "marketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "logoImages": [
    {
      object (ImageAsset)
    }
  ]
}
フィールド
finalUrl

string

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

string

出力専用。トラッキング目的でバックグラウンドで読み込まれる URL アドレス。
userSpecifiedTrackingUrl

string

省略可。ユーザーが手動で指定したトラッキング URL。
callToAction

string

必須。広告に表示される行動を促すフレーズのボタン。
headlines[]

string

必須。広告に表示される広告見出しのリスト。
descriptions[]

string

必須。広告に表示される説明文のリスト。
customParameters

map (key: string, value: string)

省略可。トラッキング URL に追加するカスタム パラメータと、それに対応する値。

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

string

省略可。モバイル デバイスで広告をクリックしたユーザーに表示されるウェブページの URL アドレスです。
finalUrlSuffix

string

省略可。ランディング ページ URL に追加する接尾辞。
businessName

string

省略可。広告に表示されるビジネスの名前。

広告主単位でデフォルト値が設定されていない限り、この設定は必須です。未設定のままにすると、デフォルト値が適用されます。
marketingImages[]

object (ImageAsset)

広告に表示されるマーケティング画像のリスト。
squareMarketingImages[]

object (ImageAsset)

広告に表示されるスクエアのマーケティング画像のリスト。
portraitMarketingImages[]

object (ImageAsset)

広告に表示される縦向きのマーケティング画像のリスト。
logoImages[]

object (ImageAsset)

広告に表示されるロゴ画像のリスト。

広告主単位でデフォルト値が設定されていない限り、この設定は必須です。未設定のままにすると、デフォルト値が適用されます。

DemandGenCarouselAd

デマンド ジェネレーション カルーセル広告の詳細。

JSON 表現 
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "cards": [
    {
      object (CarouselCard)
    }
  ],
  "finalUrlSuffix": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  }
}
フィールド
finalUrl

string

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

string

必須。広告の見出しです。
description

string

必須。広告の説明。
cards[]

object (CarouselCard)

必須。広告に表示されるカードのリスト。
finalUrlSuffix

string

省略可。ランディング ページ URL に追加する接尾辞。
trackingUrl

string

出力専用。トラッキング目的でバックグラウンドで読み込まれる URL アドレス。
userSpecifiedTrackingUrl

string

省略可。ユーザーが手動で指定したトラッキング URL。
businessName

string

省略可。広告に表示されるビジネスの名前。

この設定は、広告主単位でデフォルト値が設定されていない限り必須です。未設定のままにすると、デフォルト値が適用されます。
customParameters

map (key: string, value: string)

省略可。トラッキング URL に追加するカスタム パラメータと、それに対応する値。

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

CarouselCard

デマンド ジェネレーション カルーセル カードの詳細。

JSON 表現 
{
  "finalUrl": string,
  "finalMobileUrl": string,
  "headline": string,
  "callToAction": string,
  "marketingImage": {
    object (ImageAsset)
  },
  "squareMarketingImage": {
    object (ImageAsset)
  },
  "portraitMarketingImage": {
    object (ImageAsset)
  }
}
フィールド
finalUrl

string

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

string

省略可。モバイル デバイスでカードをクリックしたユーザーに表示されるウェブページの URL アドレスです。
headline

string

必須。カードの見出し。
callToAction

string

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

10 文字以下で入力してください。
marketingImage

object (ImageAsset)

省略可。カードに表示されるマーケティング画像。
squareMarketingImage

object (ImageAsset)

省略可。カードに表示されるスクエアのマーケティング画像。
portraitMarketingImage

object (ImageAsset)

省略可。カードに表示される縦向きのマーケティング画像。

DemandGenProductAd

デマンド ジェネレーション商品広告の詳細。

JSON 表現 
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "finalUrlSuffix": string,
  "callToAction": enum (CallToAction),
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  },
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string
}
フィールド
finalUrl

string

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

string

必須。広告の見出しです。
description

string

必須。広告の説明。
finalUrlSuffix

string

省略可。ランディング ページ URL に追加する接尾辞。
callToAction

enum (CallToAction)

必須。広告に表示される行動を促すフレーズのボタン。

サポートされている値は次のとおりです。

  • AUTOMATED
  • APPLY_NOW
  • BOOK_NOW
  • CONTACT_US
  • DOWNLOAD
  • GET_QUOTE
  • LEARN_MORE
  • SHOP_NOW
  • SIGN_UP
  • SUBSCRIBE
trackingUrl

string

出力専用。トラッキング目的でバックグラウンドで読み込まれる URL アドレス。
userSpecifiedTrackingUrl

string

省略可。ユーザーが手動で指定したトラッキング URL。
businessName

string

省略可。広告に表示されるビジネスの名前。

この設定は、広告主単位でデフォルト値が設定されていない限り必須です。未設定のままにすると、デフォルト値が適用されます。
customParameters

map (key: string, value: string)

省略可。トラッキング URL に追加するカスタム パラメータと、それに対応する値。

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

string

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

string

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

AdPolicy

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

JSON 表現 
{
  "adPolicyApprovalStatus": enum (AdPolicyApprovalStatus),
  "adPolicyReviewStatus": enum (AdPolicyReviewStatus),
  "adPolicyTopicEntry": [
    {
      object (AdPolicyTopicEntry)
    }
  ]
}
フィールド
adPolicyApprovalStatus

enum (AdPolicyApprovalStatus)

広告のポリシー承認状況。承認の決定を示します。
adPolicyReviewStatus

enum (AdPolicyReviewStatus)

広告のポリシー審査のステータス。広告が現在審査プロセスのどの段階にあるかを示します。
adPolicyTopicEntry[]

object (AdPolicyTopicEntry)

広告に関連すると特定された各ポリシートピックのエントリ。各エントリには、トピック、制限レベル、ポリシーの問題を解決するためのガイダンスが含まれています。

AdPolicyApprovalStatus

広告ポリシーの承認ステータス。

列挙型
AD_POLICY_APPROVAL_STATUS_UNKNOWN 不明または未指定。
DISAPPROVED 配信されません。
APPROVED_LIMITED 制限付きで配信されます。
APPROVED 制限なしで配信されます。
AREA_OF_INTEREST_ONLY 対象国では配信されませんが、対象国に関する情報を検索しているユーザーには配信される可能性があります。

AdPolicyReviewStatus

広告ポリシー審査のステータス。

列挙型
AD_POLICY_REVIEW_STATUS_UNKNOWN 不明または未指定。
REVIEW_IN_PROGRESS 現在審査中です。
REVIEWED 一次審査が完了しました。他の審査はまだ進行中の可能性があります。
UNDER_APPEAL 承認に向けて再送信されたか、ポリシーに関する決定に対して再審査請求が行われました。
ELIGIBLE_MAY_SERVE 有効と見なされ、配信されている可能性があります。その後、さらに審査が行われる可能性があります。

AdPolicyTopicEntry

広告が広告ポリシーに関連していると識別された方法を説明するエントリ。

JSON 表現 
{
  "policyTopic": string,
  "policyLabel": string,
  "policyTopicDescription": string,
  "policyTopicType": enum (AdPolicyTopicEntryType),
  "policyDecisionType": enum (AdPolicyDecisionType),
  "policyEnforcementMeans": enum (AdPolicyEnforcementMeans),
  "policyTopicEvidences": [
    {
      object (AdPolicyTopicEvidence)
    }
  ],
  "policyTopicConstraints": [
    {
      object (AdPolicyTopicConstraint)
    }
  ],
  "helpCenterLink": string,
  "appealInfo": {
    object (AdPolicyTopicAppealInfo)
  }
}
フィールド
policyTopic

string

ポリシーに関するトピック。

例: 「TRADEMARKS」、「ALCOHOL」など。
policyLabel

string

ポリシーのローカライズされたラベルテキスト。

例: 「テキスト内の商標」、「アルコールを含む」など。
policyTopicDescription

string

ポリシートピックの簡単な概要。
policyTopicType

enum (AdPolicyTopicEntryType)

広告ポリシーのトピックとの関連性により、広告配信がどのように影響を受けるか。
policyDecisionType

enum (AdPolicyDecisionType)

ポリシーに関する決定のソース。
policyEnforcementMeans

enum (AdPolicyEnforcementMeans)

ポリシー審査で使用されるポリシー違反措置の手段。
policyTopicEvidences[]

object (AdPolicyTopicEvidence)

ポリシーに関する決定で使用された証拠。
policyTopicConstraints[]

object (AdPolicyTopicConstraint)

ポリシーに関する決定に関連する配信制限。
appealInfo

object (AdPolicyTopicAppealInfo)

ポリシーに関する決定に対して再審査を請求する方法に関する情報。

AdPolicyTopicEntryType

広告ポリシーのトピックが配信に与える可能性のある影響。

列挙型
AD_POLICY_TOPIC_ENTRY_TYPE_UNKNOWN 不明または未指定。
PROHIBITED リソースは配信されません。
FULLY_LIMITED このリソースは、すべての対象国で配信されません。
LIMITED このリソースは一部の国では配信できません。
DESCRIPTIVE リソースを配信できます。
BROADENING リソースは配信可能であり、通常のカバレッジを超えて配信される可能性があります。
AREA_OF_INTEREST_ONLY このリソースは、すべての対象国で制限されていますが、対象国に関する情報を検索しているユーザーには表示される可能性があります。

AdPolicyDecisionType

ポリシーに関する決定の考えられるソース。

列挙型
AD_POLICY_DECISION_TYPE_UNKNOWN 不明または未指定。
PURSUANT_TO_NOTICE この決定は、法的通知、裁判所命令、商標権コンテンツ所有者からの申し立てなどに基づいています。
GOOGLE_INVESTIGATION この判定は、Google が主導した調査によるものです。

AdPolicyEnforcementMeans

ポリシー審査で使用される可能性のあるポリシー違反措置。

列挙型
AD_POLICY_ENFORCEMENT_MEANS_UNKNOWN 不明または未指定。
AUTOMATED 違反措置のプロセスは完全に自動化されていました。
HUMAN_REVIEW 人間が部分的または完全に意思決定の実施プロセスに関与した。

AdPolicyTopicEvidence

ポリシーに関する決定で使用された証拠情報。

JSON 表現 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "textList": {
    object (TextList)
  },
  "websiteList": {
    object (WebsiteList)
  },
  "httpCode": integer,
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  },
  "trademark": {
    object (Trademark)
  },
  "legalRemoval": {
    object (LegalRemoval)
  },
  "counterfeit": {
    object (Counterfeit)
  },
  "regionalRequirements": {
    object (RegionalRequirements)
  }
  // End of mutually exclusive fields.
}
フィールド
ポリシーに関する決定の証拠。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
textList

object (TextList)

広告のテキストで見つかった証拠のリスト。
websiteList

object (WebsiteList)

広告にリンクされているウェブサイトのリスト。
httpCode

integer

最終 URL のクロール時に返された HTTP コード。
languageCode

string

広告が書かれていると検出された言語。

このフィールドでは、IETF 言語タグ（「en-US」など）を使用します。
destinationTextList

object (DestinationTextList)

ポリシー違反の原因となっている広告のリンク先のテキスト。
destinationMismatch

object (DestinationMismatch)

広告のリンク先 URL が一致していない。
destinationNotWorking

object (DestinationNotWorking)

広告のリンク先に関連する HTTP エラーまたは DNS エラーに関する情報。
trademark

object (Trademark)

ポリシー違反の原因となった商標用語。
legalRemoval

object (LegalRemoval)

ポリシー違反の原因となった、法律関連の規制の適用。
counterfeit

object (Counterfeit)

ポリシー違反の原因となった偽造品に対する措置。
regionalRequirements

object (RegionalRequirements)

ポリシー違反を引き起こした T&S の積極的な違反措置。
相互に排他的なフィールドの終了。

TextList

ポリシーに違反したテキストのフラグメントのリスト。

JSON 表現 
{
  "texts": [
    string
  ]
}
フィールド
texts[]

string

ポリシーの検出結果の原因となったリソースのテキストの断片。

WebsiteList

ポリシーに違反したウェブサイトのリスト。

JSON 表現 
{
  "websites": [
    string
  ]
}
フィールド
websites[]

string

ポリシー違反の原因となったウェブサイト。

DestinationTextList

ポリシーに違反したリンク先テキストのリスト。

JSON 表現 
{
  "destinationTexts": [
    string
  ]
}
フィールド
destinationTexts[]

string

ポリシーの検出結果の原因となった宛先テキスト。

DestinationMismatch

リンク先 URL のタイプの不一致に関する詳細。

JSON 表現 
{
  "uriTypes": [
    enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
フィールド
uriTypes[]

enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)

一致しない URL のセット。リストには、1 つまたは複数の URI タイプを含めることができます。

例 1: [DISPLAY_URL, FINAL_URL] は、広告の表示 URL が広告の最終ページ URL と一致していないことを意味します。

例 2: [FINAL_URL] は、広告の最終ページ URL がクロールされた URL と一致しなかったことを意味します。これも不適切なリンク先と見なされます。

AdPolicyTopicEvidenceDestinationMismatchUrlType

URL のタイプ。

列挙型
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_MISMATCH_URL_TYPE_UNKNOWN 指定されていないか、不明です。
DISPLAY_URL 表示 URL。
FINAL_URL 最終ページ URL。
FINAL_MOBILE_URL モバイルの最終ページ URL。
TRACKING_URL トラッキング URL。
MOBILE_TRACKING_URL モバイル トラッキング URL。

DestinationNotWorking

広告のリンク先に関連する HTTP エラーまたは DNS エラーの詳細。

JSON 表現 
{
  "expandedUri": string,
  "device": enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType),
  "lastCheckedTime": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dnsErrorType": enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of mutually exclusive fields.
}
フィールド
expandedUri

string

機能しなかった完全な URL。
device

enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType)

URL へのアクセスでエラーが発生したデバイス。
lastCheckedTime

string (Timestamp format)

URL への移動時にエラーが最後に確認された日時。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
HTTP エラーまたは DNS エラー。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
dnsErrorType

enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

DNS エラーのタイプ。
httpErrorCode

string (int64 format)

HTTP エラーコード。
相互に排他的なフィールドの終了。

AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType

考えられる DNS エラータイプ。

列挙型
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DNS_ERROR_TYPE_UNKNOWN 指定されていないか、不明です。
HOSTNAME_NOT_FOUND ランディング ページの取得時に、DNS でホスト名が見つかりませんでした。
GOOGLE_CRAWLER_DNS_ISSUE DNS との通信時に、Google がランディング ページをクロールできませんでした。

AdPolicyTopicEvidenceDestinationNotWorkingDeviceType

URL にアクセスしたときにエラーが発生した可能性のあるデバイス。

列挙型
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DEVICE_TYPE_UNKNOWN 指定されていないか、不明です。
DESKTOP デスクトップ デバイス。
ANDROID Android デバイス。
IOS iOS デバイス。

商標

ポリシー違反の原因となった商標用語。

JSON 表現 
{
  "owner": string,
  "term": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
フィールド
owner

string

商標コンテンツの所有者。
term

string

商標用語。
countryRestrictions[]

object (AdPolicyCriterionRestriction)

ポリシー違反が関連する国。

AdPolicyCriterionRestriction

国別のポリシーを表します。

JSON 表現 
{
  "countryCriterionId": string,
  "countryLabel": string
}
フィールド
countryCriterionId

string (int64 format)

国の条件 ID。
countryLabel

string

ローカライズされた国名。空の場合もあります。

LegalRemoval

DMCA または現地の法規制に基づく、法的な規制の適用。

JSON 表現 
{
  "complaintType": enum (AdPolicyTopicEvidenceLegalRemovalComplaintType),
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ],
  "restrictedUris": [
    string
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dmca": {
    object (Dmca)
  },
  "localLegal": {
    object (LocalLegal)
  }
  // End of mutually exclusive fields.
}
フィールド
complaintType

enum (AdPolicyTopicEvidenceLegalRemovalComplaintType)

法的な削除の原因となった申し立ての種類。
countryRestrictions[]

object (AdPolicyCriterionRestriction)

法的な削除により制限されている国。
restrictedUris[]

string

法的な削除により制限された URL。
法的な削除の種類の詳細。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
dmca

object (Dmca)

DMCA 規制に基づく法的な削除の詳細。
相互に排他的なフィールドの終了。

DMCA

DMCA に基づく申し立ての詳細。

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

string

法的申し立てを行ったエンティティ。

LocalLegal

地域の法規制の詳細。

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

string

法的通知の法律の種類。

AdPolicyTopicEvidenceLegalRemovalComplaintType

法的な削除に関する申し立ての種類。

列挙型
COPYRIGHT

著作権。

DMCA にのみ適用されます。
COURT_ORDER

裁判所命令。

現地の法務にのみ適用されます。

偽造品

ポリシー違反の原因となった偽造品に対する違反措置の詳細。

JSON 表現 
{
  "owners": [
    string
  ]
}
フィールド
owners[]

string

申し立てを行ったコンテンツまたはプロダクトの所有者。

RegionalRequirements

地域の要件に対応することを目的としたポリシーに対する、Trust & Safety（T&S）による積極的な違反措置。これは、T&S の積極的な違反措置であるため、規制通知ではなく、Google が所有する調査と見なされます。

JSON 表現 
{
  "regionalRequirementsEntries": [
    {
      object (RegionalRequirementsEntry)
    }
  ]
}
フィールド
regionalRequirementsEntries[]

object (RegionalRequirementsEntry)

地域ごとの要件のリスト。

RegionalRequirementsEntry

ポリシーレベルの地域別の法律違反の詳細。

JSON 表現 
{
  "legalPolicy": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
フィールド
legalPolicy

string

違反している法律に関するポリシー。
countryRestrictions[]

object (AdPolicyCriterionRestriction)

法律に関するポリシーにより制限されている国。

AdPolicyTopicConstraint

広告配信の制約に関する詳細。

JSON 表現 
{
  "requestCertificateFormLink": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "countryConstraint": {
    object (AdPolicyCountryConstraintList)
  },
  "resellerConstraint": {
    object (AdPolicyResellerConstraint)
  },
  "certificateMissingCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "certificateDomainMismatchCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "globalCertificateMissing": {
    object (AdPolicyGlobalCertificateMissingConstraint)
  },
  "globalCertificateDomainMismatch": {
    object (AdPolicyGlobalCertificateDomainMismatchConstraint)
  }
  // End of mutually exclusive fields.
}
フィールド
サービス提供の制約。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
countryConstraint

object (AdPolicyCountryConstraintList)

広告を配信できない国。
resellerConstraint

object (AdPolicyResellerConstraint)

販売パートナーの制約。
certificateMissingCountryList

object (AdPolicyCountryConstraintList)

配信に証明書が必要な国。
certificateDomainMismatchCountryList

object (AdPolicyCountryConstraintList)

リソースのドメインが、関連付けられている証明書の対象外となっている国。
globalCertificateMissing

object (AdPolicyGlobalCertificateMissingConstraint)

どの国でも配信するには認証が必要です。
globalCertificateDomainMismatch

object (AdPolicyGlobalCertificateDomainMismatchConstraint)

いずれかの国で配信するには証明書が必要ですが、既存の証明書は広告のドメインをカバーしていません。
相互に排他的なフィールドの終了。

AdPolicyCountryConstraintList

ポリシーの制約により広告を配信できない国のリスト。

JSON 表現 
{
  "countries": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
フィールド
countries[]

object (AdPolicyCriterionRestriction)

広告を配信できない国。

AdPolicyResellerConstraint

この型にはフィールドがありません。

再販目的のウェブサイトが不承認となったため、ポリシーに関するトピックが制限されました。

AdPolicyGlobalCertificateMissingConstraint

この型にはフィールドがありません。

どの国でも配信するには認証が必要です。

AdPolicyGlobalCertificateDomainMismatchConstraint

この型にはフィールドがありません。

いずれかの国で配信するには証明書が必要ですが、既存の証明書は広告のドメインをカバーしていません。

AdPolicyTopicAppealInfo

ポリシーに関する決定に対して再審査を請求する方法に関する情報。

JSON 表現 
{
  "appealType": enum (AdPolicyAppealType),
  "appealFormLink": string
}
フィールド
appealType

enum (AdPolicyAppealType)

セルフサービスによる再審査請求または再審査請求フォームを使用して再審査請求できるかどうか。

AdPolicyAppealType

再審査請求のタイプ。

列挙型
AD_POLICY_APPEAL_TYPE_UNKNOWN 不明または未指定。
SELF_SERVICE_APPEAL この決定に対しては、セルフサービスによる再審査請求を行うことができます。
APPEAL_FORM この決定に対しては、再審査請求フォームを使用して再審査請求を行うことができます。

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。

DcmTrackingInfo

DCM トラッキングの詳細。

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

string (int64 format)

必須。DCM プレースメント ID。
trackingAdId

string (int64 format)

必須。DCM トラッキング広告 ID。
creativeId

string (int64 format)

必須。DCM クリエイティブ ID。

メソッド

create

 広告グループ広告を作成します。

delete

 広告グループの広告を削除します。

get

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

list

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

patch

 広告グループ広告を更新します。