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

  // 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 バイトにする必要があります。

adPolicy

object (AdPolicy)

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

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)

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

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)の事前対応。これは、事前対応型の利用規約とポリシーの違反措置であるため、規制通知ではなく 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)
}
フィールド
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

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