REST Resource: advertisers.adGroupAds

資源:AdGroupAd

與廣告群組相關聯的單一廣告。

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)

廣告使用的網址清單。

聯集欄位 ad_details。廣告的詳細資料。

ad_details 只能是下列其中一項:

displayVideoSourceAd

object (DisplayVideoSourceAd)

廣告詳細資料,來源為 Display & Video 360 廣告素材。

mastheadAd

object (MastheadAd)

在 YouTube 首頁推薦內容中放送的廣告詳細資料。

inStreamAd

object (InStreamAd)

可略過的串流內廣告詳細資料,用於提升品牌知名度或達成觸及行銷目標。

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

政策主題。

例如「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 表示法
{

  // 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

檢索最終到達網址時傳回的 HTTP 程式碼。

languageCode

string

系統偵測到的廣告撰寫語言。

這個欄位使用 IETF 語言代碼,例如「en-US」。

destinationTextList

object (DestinationTextList)

廣告到達網頁中導致違反政策的文字。

destinationMismatch

object (DestinationMismatch)

廣告到達網頁網址不一致。

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

到達網頁網址類型不符的詳細資料。

JSON 表示法
{
  "uriTypes": [
    enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
欄位
uriTypes[]

enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)

不相符的網址集。清單可以包含單一或多個 URI 類型。

示例 1:[DISPLAY_URL, FINAL_URL] 表示廣告顯示網址與廣告最終到達網址不符。

範例 2:[FINAL_URL] 表示廣告最終到達網址與檢索網址不符,這也視為到達網頁不符。

AdPolicyTopicEvidenceDestinationMismatchUrlType

可能的網址類型。

列舉
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_MISMATCH_URL_TYPE_UNKNOWN 未指定或不明。
DISPLAY_URL 顯示網址。
FINAL_URL 最終到達網址。
FINAL_MOBILE_URL 最終行動版網址。
TRACKING_URL 追蹤網址。
MOBILE_TRACKING_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

無法正常運作的完整網址。

device

enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType)

造訪網址時發生錯誤的裝置。

lastCheckedTime

string (Timestamp format)

上次瀏覽網址時發生錯誤的時間。

使用 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 與 DNS 通訊時,Google 無法檢索到達網頁。

AdPolicyTopicEvidenceDestinationNotWorkingDeviceType

可能在造訪網址時發生錯誤的裝置。

列舉
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

由於法律移除要求,這些網址受到限制。

聯集欄位 type。依法移除的類型詳細資料。type 只能是下列其中一項:
dmca

object (Dmca)

詳細瞭解依據《數位千禧年著作權法》(DMCA) 規定移除內容的法律程序。

數位千禧年著作權法 (DMCA)

數位千禧年著作權法申訴詳細資料。

JSON 表示法
{
  "complainant": string
}
欄位
complainant

string

提出法律申訴的實體。

LocalLegal

當地法律規範詳情。

JSON 表示法
{
  "lawType": string
}
欄位
lawType

string

法律聲明的法律類型。

AdPolicyTopicEvidenceLegalRemovalComplaintType

可依法移除內容的可能申訴類型。

列舉
COPYRIGHT

版權。

僅適用於《數位千禧年著作權法》。

COURT_ORDER

法院命令。

僅適用於當地法律。

仿冒商品

因仿冒商品強制執行措施而違反政策的詳細資料。

JSON 表示法
{
  "owners": [
    string
  ]
}
欄位
owners[]

string

提出申訴的內容或產品擁有者。

RegionalRequirements

針對旨在因應區域性需求的政策,信任與安全 (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

廣告素材來自 DV360 廣告素材。

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)

影片自動播放的時間長度。

時間長度以秒為單位,最多可有 9 個小數位數,並應以「s」結尾,例如:"3.5s"

callToActionButtonLabel

string

行動號召按鈕上的文字。

callToActionFinalUrl

string

行動號召按鈕的到達網頁網址。

callToActionTrackingUrl

string

行動號召按鈕的追蹤網址。

showChannelArt

boolean

是否顯示 YouTube 頁面頂端的背景或橫幅圖片。

companionYoutubeVideos[]

object (YoutubeVideoDetails)

顯示在電腦版刊頭廣告旁邊的影片。最多只能有兩個。

YoutubeVideoDetails

YouTube 影片的詳細資料。

JSON 表示法
{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason)
}
欄位
id

string

YouTube 影片 ID,可在 YouTube 網頁上搜尋。

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)

將自訂值傳送至追蹤網址範本的自訂參數。

這個物件中包含 "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

使用者點按廣告後前往的網頁網址。

trackingUrl

string

系統會在背景載入這個網址,以利追蹤。

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)

將自訂值傳送至追蹤網址範本的自訂參數。

這個物件中包含 "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

使用者點按廣告後前往的網頁網址。

trackingUrl

string

系統會在背景載入這個網址,以利追蹤。

video

object (YoutubeVideoDetails)

廣告的 YouTube 影片。

VideoDiscoveryAd

影片探索廣告的詳細資料。

JSON 表示法
{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}
欄位
headline

string

廣告標題。

description1

string

廣告的第一行文字。

description2

string

廣告的第二行文字。

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

使用者點按廣告後前往的網頁網址。

trackingUrl

string

系統會在背景載入這個網址,以利追蹤。

actionButtonLabels[]

string

行動號召按鈕上顯示的文字素材資源清單。

headlines[]

string

行動號召橫幅上顯示的廣告標題清單。

longHeadlines[]

string

行動號召橫幅上顯示的獨立廣告標題清單。

descriptions[]

string

行動號召橫幅上顯示的說明清單。

displayUrlBreadcrumb1

string

顯示網址中網域後的第一個部分。

displayUrlBreadcrumb2

string

顯示網址中網域之後的第二個部分。

domain

string

顯示網址的網域。

videos[]

object (YoutubeVideoDetails)

這則廣告使用的 YouTube 影片素材資源清單。

customParameters

map (key: string, value: string)

將自訂值傳送至追蹤網址範本的自訂參數。

這個物件中包含 "key": value 組合的清單,範例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }

companionBanners[]

object (ImageAsset)

這個廣告使用的隨播橫幅清單。

AdUrl

與廣告相關的其他網址,包括信號。

JSON 表示法
{
  "type": enum (AdUrlType),
  "url": string
}
欄位
type

enum (AdUrlType)

廣告網址類型。

url

string

網址字串值。

AdUrlType

可能的廣告網址類型。

列舉
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 的追蹤網址。
AD_URL_TYPE_BEACON_SKIP 略過事件觸發時要 Ping 的追蹤網址。

方法

get

取得廣告群組廣告。

list

列出廣告群組廣告。