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)
  },

  // 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)
  },
  "demandGenVideoAd": {
    object (DemandGenVideoAd)
  },
  "demandGenImageAd": {
    object (DemandGenImageAd)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAd)
  },
  "demandGenProductAd": {
    object (DemandGenProductAd)
  }
  // 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

必須。広告の表示名。

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

object (AdPolicy)

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

enum (EntityStatus)

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

object (AdUrl)

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

object (DcmTrackingInfo)

省略可。DCM トラッキング広告情報。デマンド ジェネレーション広告でのみ有効です。

DCM トラッキング広告の情報を削除するには、このフィールドを空のままにしてください。
共用体フィールド 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)

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

object (DemandGenVideoAd)

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

object (DemandGenImageAd)

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

object (DemandGenProductAd)

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

AdPolicy

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

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

ポリシーのトピック。

例: 「商標」、「アルコール」など。
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 表現 
{

  // Union field value can be only one of the following:
  "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 list of possible types for union field value.
}
フィールド
共用体フィールド value。ポリシーに関する決定の根拠。value は次のいずれかになります。
textList

object (TextList)

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

object (WebsiteList)

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

integer

最終的な URL がクロールされたときに返される HTTP コード。
languageCode

string

広告の作成に使用された言語。

このフィールドでは、「en-US」などの IETF 言語タグを使用します。
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,

  // Union field reason can be only one of the following:
  "dnsErrorType": enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of list of possible types for union field reason.
}
フィールド
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"。
共用体フィールド reason。HTTP エラーまたは DNS エラー。reason は次のいずれかになります。
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 Google が DNS と通信する際に、ランディング ページをクロールできませんでした。

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
  ],

  // Union field type can be only one of the following:
  "dmca": {
    object (Dmca)
  },
  "localLegal": {
    object (LocalLegal)
  }
  // End of list of possible types for union field type.
}
フィールド
complaintType

enum (AdPolicyTopicEvidenceLegalRemovalComplaintType)

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

object (AdPolicyCriterionRestriction)

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

string

法的削除により制限された URL。
共用体フィールド type。法的削除の種類の詳細。type は次のいずれかになります。
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,

  // Union field constraint can be only one of the following:
  "countryConstraint": {
    object (AdPolicyCountryConstraintList)
  },
  "resellerConstraint": {
    object (AdPolicyResellerConstraint)
  },
  "certificateMissingCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "certificateDomainMismatchCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "globalCertificateMissing": {
    object (AdPolicyGlobalCertificateMissingConstraint)
  },
  "globalCertificateDomainMismatch": {
    object (AdPolicyGlobalCertificateDomainMismatchConstraint)
  }
  // End of list of possible types for union field constraint.
}
フィールド
共用体フィールド constraint。配信制約。constraint は次のいずれかになります。
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 この決定に対しては、再審査請求フォームを使用して再審査を請求できます。

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,
  "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,
  "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,
  "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)

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

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 番目の部分。

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

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