- 資源:AdGroupAd
- AdPolicy
- AdPolicyApprovalStatus
- AdPolicyReviewStatus
- AdPolicyTopicEntry
- AdPolicyTopicEntryType
- AdPolicyDecisionType
- AdPolicyEnforcementMeans
- AdPolicyTopicEvidence
- TextList
- WebsiteList
- DestinationTextList
- DestinationMismatch
- AdPolicyTopicEvidenceDestinationMismatchUrlType
- DestinationNotWorking
- AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType
- AdPolicyTopicEvidenceDestinationNotWorkingDeviceType
- 商標
- AdPolicyCriterionRestriction
- LegalRemoval
- Dmca
- LocalLegal
- AdPolicyTopicEvidenceLegalRemovalComplaintType
- 仿冒商品
- RegionalRequirements
- RegionalRequirementsEntry
- AdPolicyTopicConstraint
- AdPolicyCountryConstraintList
- AdPolicyResellerConstraint
- AdPolicyGlobalCertificateMissingConstraint
- AdPolicyGlobalCertificateDomainMismatchConstraint
- AdPolicyTopicAppealInfo
- AdPolicyAppealType
- DisplayVideoSourceAd
- MastheadAd
- YoutubeVideoDetails
- VideoUnavailableReason
- VideoAspectRatio
- InStreamAd
- CommonInStreamAttribute
- ImageAsset
- NonSkippableAd
- BumperAd
- AudioAd
- VideoDiscoveryAd
- 縮圖
- VideoPerformanceAd
- AdUrl
- AdUrlType
- 方法
資源:AdGroupAd
與廣告群組相關聯的單一廣告。
| JSON 表示法 | 
|---|
| { "name": string, "advertiserId": string, "adGroupAdId": string, "adGroupId": string, "displayName": string, "adPolicy": { object ( | 
| 欄位 | |
|---|---|
| name | 
 廣告的資源名稱。 | 
| advertiserId | 
 廣告所屬廣告主的專屬 ID。 | 
| adGroupAdId | 
 廣告的專屬 ID。由系統指派。 | 
| adGroupId | 
 廣告所屬廣告群組的專屬 ID。 | 
| displayName | 
 廣告的顯示名稱。 必須採用 UTF-8 編碼,大小上限為 255 個位元組。 | 
| adPolicy | 
 廣告的政策核准狀態。 | 
| entityStatus | 
 廣告的實體狀態。 | 
| adUrls[] | 
 廣告使用的網址清單。 | 
| 聯集欄位  ad_details只能是下列其中一項: | |
| displayVideoSourceAd | 
 廣告詳細資料,來源為 Display & Video 360 廣告素材。 | 
| mastheadAd | 
 | 
| inStreamAd | 
 可略過的串流內廣告詳細資料,用於提升品牌知名度或達成觸及行銷目標。 | 
| nonSkippableAd | 
 不可略過的短串流內影片廣告詳細資料,長度介於 6 到 15 秒,用於觸及行銷目標。 | 
| bumperAd | 
 用於觸及的不可略過的短片廣告詳細資料,長度等於或短於 6 秒。 | 
| audioAd | 
 用於觸及行銷目標的音訊廣告詳細資料。 | 
| videoDiscoverAd | 
 宣傳影片的廣告詳細資料,會顯示在探索位置。 | 
| videoPerformanceAd | 
 影片行動廣告活動中使用的廣告詳細資料,可吸引使用者對商家、服務或產品採取行動。 | 
AdPolicy
與廣告群組廣告相關聯的單一廣告政策。
| JSON 表示法 | 
|---|
| { "adPolicyApprovalStatus": enum ( | 
| 欄位 | |
|---|---|
| adPolicyApprovalStatus | 
 廣告的政策核准狀態,指出核准裁決。 | 
| adPolicyReviewStatus | 
 廣告的政策審查狀態,指出廣告目前處於審查程序的哪個階段。 | 
| 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 ( | 
| 欄位 | |
|---|---|
| policyTopic | 
 政策主題。 例如「TRADEMARKS」、「ALCOHOL」等。 | 
| policyLabel | 
 政策的本地化標籤文字。 例如「文字中的商標」和「含有酒精」等。 | 
| policyTopicDescription | 
 政策主題的簡短摘要說明。 | 
| policyTopicType | 
 廣告放送會受到哪些與廣告政策主題相關的影響。 | 
| policyDecisionType | 
 政策裁決的來源。 | 
| policyEnforcementMeans | 
 政策審查時採用的政策執行方式。 | 
| policyTopicEvidences[] | 
 政策決策所依據的證據。 | 
| policyTopicConstraints[] | 
 與政策裁決相關的放送限制。 | 
| helpCenterLink | 
 政策主題的廣告政策說明中心連結。 | 
| appealInfo | 
 如何對政策裁決提出申訴。 | 
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。政策裁決的證據。value只能是下列其中一項: | |
| textList | 
 廣告內文中發現的證據清單。 | 
| websiteList | 
 與廣告連結的網站清單。 | 
| httpCode | 
 檢索最終到達網址時傳回的 HTTP 程式碼。 | 
| languageCode | 
 系統偵測到的廣告撰寫語言。 這個欄位使用 IETF 語言代碼,例如「en-US」。 | 
| destinationTextList | 
 廣告到達網頁中導致違反政策的文字。 | 
| destinationMismatch | 
 廣告到達網頁網址不一致。 | 
| destinationNotWorking | 
 與廣告到達網頁相關的 HTTP 或 DNS 錯誤資訊。 | 
| trademark | 
 導致違反政策的商標字詞。 | 
| legalRemoval | 
 因法律相關法規強制執行而違反政策。 | 
| counterfeit | 
 因仿冒商品處置措施而違反政策。 | 
| regionalRequirements | 
 T&S 主動執行的違規處置,導致違反政策。 | 
TextList
違反政策的文字片段清單。
| JSON 表示法 | 
|---|
| { "texts": [ string ] } | 
| 欄位 | |
|---|---|
| texts[] | 
 導致政策發現結果的資源文字片段。 | 
WebsiteList
違反政策的網站清單。
| JSON 表示法 | 
|---|
| { "websites": [ string ] } | 
| 欄位 | |
|---|---|
| websites[] | 
 導致政策結果的網站。 | 
DestinationTextList
違反政策的目的地文字清單。
| JSON 表示法 | 
|---|
| { "destinationTexts": [ string ] } | 
| 欄位 | |
|---|---|
| destinationTexts[] | 
 導致政策結果的到達網頁文字。 | 
DestinationMismatch
到達網頁網址類型不符的詳細資料。
| JSON 表示法 | 
|---|
| {
  "uriTypes": [
    enum ( | 
| 欄位 | |
|---|---|
| uriTypes[] | 
 不相符的網址集。清單可以包含單一或多個 URI 類型。 示例 1:[ 範例 2:[ | 
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 ( | 
| 欄位 | |
|---|---|
| expandedUri | 
 無法正常運作的完整網址。 | 
| device | 
 造訪網址時發生錯誤的裝置。 | 
| lastCheckedTime | 
 上次瀏覽網址時發生錯誤的時間。 使用 RFC 3339,產生的輸出內容一律會經過 Z 標準化,並使用 0、3、6 或 9 個小數點後位數。系統也接受「Z」以外的偏移量。例如: | 
| 聯集欄位 reason。HTTP 或 DNS 錯誤。reason只能是下列其中一項: | |
| dnsErrorType | 
 DNS 錯誤類型。 | 
| httpErrorCode | 
 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 ( | 
| 欄位 | |
|---|---|
| owner | 
 商標內容擁有者。 | 
| term | 
 商標字詞。 | 
| countryRestrictions[] | 
 違反政策行為的相關國家/地區。 | 
AdPolicyCriterionRestriction
代表國家/地區限制。
| JSON 表示法 | 
|---|
| { "countryCriterionId": string, "countryLabel": string } | 
| 欄位 | |
|---|---|
| countryCriterionId | 
 國家/地區條件 ID。 | 
| countryLabel | 
 國家/地區的本地化名稱。可以留空。 | 
LegalRemoval
執行與法律相關的法規,包括《數位千禧年著作權法》(DMCA) 或當地法律法規。
| JSON 表示法 | 
|---|
| { "complaintType": enum ( | 
| 欄位 | |
|---|---|
| complaintType | 
 導致依法移除內容的申訴類型。 | 
| countryRestrictions[] | 
 因法律移除而受到限制的國家/地區。 | 
| restrictedUris[] | 
 由於法律移除要求,這些網址受到限制。 | 
| 聯集欄位 type。依法移除的類型詳細資料。type只能是下列其中一項: | |
| dmca | 
 詳細瞭解依據《數位千禧年著作權法》(DMCA) 規定移除內容的法律程序。 | 
| localLegal | 
 當地法律法規的依法移除詳細資料。 | 
數位千禧年著作權法 (DMCA)
數位千禧年著作權法申訴詳細資料。
| JSON 表示法 | 
|---|
| { "complainant": string } | 
| 欄位 | |
|---|---|
| complainant | 
 提出法律申訴的實體。 | 
LocalLegal
當地法律規範詳情。
| JSON 表示法 | 
|---|
| { "lawType": string } | 
| 欄位 | |
|---|---|
| lawType | 
 法律聲明的法律類型。 | 
AdPolicyTopicEvidenceLegalRemovalComplaintType
可依法移除內容的可能申訴類型。
| 列舉 | |
|---|---|
| AD_POLICY_TOPIC_EVIDENCE_LEGAL_REMOVAL_COMPLAINT_TYPE_UNKNOWN | 未指定或不明。 | 
| COPYRIGHT | 版權。 僅適用於《數位千禧年著作權法》。 | 
| COURT_ORDER | 法院命令。 僅適用於當地法律。 | 
| LOCAL_LEGAL | 當地法律規定。 僅適用於當地法律。 | 
仿冒商品
因仿冒商品強制執行措施而違反政策的詳細資料。
| JSON 表示法 | 
|---|
| { "owners": [ string ] } | 
| 欄位 | |
|---|---|
| owners[] | 
 提出申訴的內容或產品擁有者。 | 
RegionalRequirements
針對旨在因應區域性需求的政策,信任與安全 (T&S) 團隊會主動執行違規處置。由於這是主動執行的條款及細則強制措施,因此視為 Google 主導的調查,而非法規通知。
| JSON 表示法 | 
|---|
| {
  "regionalRequirementsEntries": [
    {
      object ( | 
| 欄位 | |
|---|---|
| regionalRequirementsEntries[] | 
 區域規定清單。 | 
RegionalRequirementsEntry
政策層級的區域性法律違規詳情。
| JSON 表示法 | 
|---|
| {
  "legalPolicy": string,
  "countryRestrictions": [
    {
      object ( | 
| 欄位 | |
|---|---|
| legalPolicy | 
 違反的法律政策。 | 
| countryRestrictions[] | 
 因法律政策而受到限制的國家/地區。 | 
AdPolicyTopicConstraint
廣告放送限制的詳細資料。
| JSON 表示法 | 
|---|
| { "requestCertificateFormLink": string, // Union field | 
| 欄位 | |
|---|---|
| requestCertificateFormLink | 
 要求限制憑證的表單連結。 | 
| 聯集欄位 constraint。放送限制。constraint只能是下列其中一項: | |
| countryConstraint | 
 廣告無法放送的國家/地區。 | 
| resellerConstraint | 
 經銷商限制。 | 
| certificateMissingCountryList | 
 提供服務時必須出示認證的國家/地區。 | 
| certificateDomainMismatchCountryList | 
 資源網域未涵蓋在相關聯憑證中的國家/地區。 | 
| globalCertificateMissing | 
 如要在任何國家/地區放送,都必須提供認證。 | 
| globalCertificateDomainMismatch | 
 廣告必須具備憑證才能在任何國家/地區放送,但現有憑證未涵蓋廣告網域。 | 
AdPolicyCountryConstraintList
因政策限制而無法放送廣告的國家/地區清單。
| JSON 表示法 | 
|---|
| {
  "countries": [
    {
      object ( | 
| 欄位 | |
|---|---|
| countries[] | 
 廣告無法放送的國家/地區。 | 
AdPolicyResellerConstraint
這個類型沒有任何欄位。
網站因轉售目的而遭到拒登,因此政策主題受到限制。
AdPolicyGlobalCertificateMissingConstraint
這個類型沒有任何欄位。
如要在任何國家/地區放送,都必須提供認證。
AdPolicyGlobalCertificateDomainMismatchConstraint
這個類型沒有任何欄位。
廣告必須具備憑證才能在任何國家/地區放送,但現有憑證未涵蓋廣告網域。
AdPolicyTopicAppealInfo
如何對政策裁決提出申訴。
| JSON 表示法 | 
|---|
| {
  "appealType": enum ( | 
| 欄位 | |
|---|---|
| appealType | 
 是否可透過自助式申訴或申訴表單提出申訴。 | 
| appealFormLink | 
 只有在  | 
AdPolicyAppealType
可申訴的類型。
| 列舉 | |
|---|---|
| AD_POLICY_APPEAL_TYPE_UNKNOWN | 不明或未指定。 | 
| SELF_SERVICE_APPEAL | 你可以透過自助式申訴對這項裁決提出申訴。 | 
| APPEAL_FORM | 如要對這項決定提出申訴,請填寫申訴表單。 | 
DisplayVideoSourceAd
廣告素材來自 DV360 廣告素材。
| JSON 表示法 | 
|---|
| { "creativeId": string } | 
| 欄位 | |
|---|---|
| creativeId | 
 來源廣告素材的 ID。 | 
MastheadAd
刊頭廣告的詳細資料。
| JSON 表示法 | 
|---|
| { "video": { object ( | 
| 欄位 | |
|---|---|
| video | 
 廣告使用的 YouTube 影片。 | 
| headline | 
 廣告標題。 | 
| description | 
 廣告說明。 | 
| videoAspectRatio | 
 刊頭廣告中自動播放的 YouTube 影片長寬比。 | 
| autoplayVideoStartMillisecond | 
 影片開始播放的時間 (以毫秒為單位)。 | 
| autoplayVideoDuration | 
 影片自動播放的時間長度。 時間長度以秒為單位,最多可有 9 個小數位數,並應以「 | 
| callToActionButtonLabel | 
 行動號召按鈕上的文字。 | 
| callToActionFinalUrl | 
 行動號召按鈕的到達網頁網址。 | 
| callToActionTrackingUrl | 
 行動號召按鈕的追蹤網址。 | 
| showChannelArt | 
 是否顯示 YouTube 頁面頂端的背景或橫幅圖片。 | 
| companionYoutubeVideos[] | 
 顯示在電腦版刊頭廣告旁邊的影片。最多只能有兩個。 | 
YoutubeVideoDetails
YouTube 影片的詳細資料。
| JSON 表示法 | 
|---|
| {
  "id": string,
  "unavailableReason": enum ( | 
| 欄位 | |
|---|---|
| id | 
 YouTube 影片 ID,可在 YouTube 網頁上搜尋。 | 
| unavailableReason | 
 影片資料無法使用的原因。 | 
VideoAspectRatio
YouTube 影片的顯示比例。
| 列舉 | |
|---|---|
| VIDEO_ASPECT_RATIO_UNSPECIFIED | 未指定或不明。 | 
| VIDEO_ASPECT_RATIO_WIDESCREEN | 影片會遭到拉伸,頂端和底部會遭到裁剪。 | 
| VIDEO_ASPECT_RATIO_FIXED_16_9 | 影片採用固定 16:9 的顯示比例。 | 
InStreamAd
串流內廣告的詳細資料。
| JSON 表示法 | 
|---|
| {
  "commonInStreamAttribute": {
    object ( | 
| 欄位 | |
|---|---|
| commonInStreamAttribute | 
 常見廣告屬性。 | 
| customParameters | 
 將自訂值傳送至追蹤網址範本的自訂參數。 這個物件中包含  | 
CommonInStreamAttribute
串流內廣告、不可略過廣告和串場廣告的常見屬性。
| JSON 表示法 | 
|---|
| { "displayUrl": string, "finalUrl": string, "trackingUrl": string, "actionButtonLabel": string, "actionHeadline": string, "video": { object ( | 
| 欄位 | |
|---|---|
| displayUrl | 
 與廣告一起顯示的網頁網址。 | 
| finalUrl | 
 使用者點按廣告後前往的網頁網址。 | 
| trackingUrl | 
 系統會在背景載入這個網址,以利追蹤。 | 
| actionButtonLabel | 
 行動號召按鈕上的文字。 | 
| actionHeadline | 
 行動號召橫幅的標題。 | 
| video | 
 廣告的 YouTube 影片。 | 
| companionBanner | 
 顯示在影片廣告旁的圖片。 | 
ImageAsset
圖片素材資源的中繼資料。
| JSON 表示法 | 
|---|
| {
  "mimeType": string,
  "fullSize": {
    object ( | 
| 欄位 | |
|---|---|
| mimeType | 
 圖片素材資源的 MIME 類型。 | 
| fullSize | 
 這張圖片原尺寸的中繼資料。 | 
| fileSize | 
 圖片素材資源的檔案大小 (以位元組為單位)。 | 
NonSkippableAd
不可略過廣告的詳細資料。
| JSON 表示法 | 
|---|
| {
  "commonInStreamAttribute": {
    object ( | 
| 欄位 | |
|---|---|
| commonInStreamAttribute | 
 常見廣告屬性。 | 
| customParameters | 
 將自訂值傳送至追蹤網址範本的自訂參數。 這個物件中包含  | 
BumperAd
串場廣告的詳細資料。
| JSON 表示法 | 
|---|
| {
  "commonInStreamAttribute": {
    object ( | 
| 欄位 | |
|---|---|
| commonInStreamAttribute | 
 常見廣告屬性。 | 
AudioAd
音訊廣告的詳細資料。
| JSON 表示法 | 
|---|
| {
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object ( | 
| 欄位 | |
|---|---|
| displayUrl | 
 與廣告一起顯示的網頁網址。 | 
| finalUrl | 
 使用者點按廣告後前往的網頁網址。 | 
| trackingUrl | 
 系統會在背景載入這個網址,以利追蹤。 | 
| video | 
 廣告的 YouTube 影片。 | 
VideoDiscoveryAd
影片探索廣告的詳細資料。
| JSON 表示法 | 
|---|
| { "headline": string, "description1": string, "description2": string, "video": { object ( | 
| 欄位 | |
|---|---|
| headline | 
 廣告標題。 | 
| description1 | 
 廣告的第一行文字。 | 
| description2 | 
 廣告的第二行文字。 | 
| video | 
 廣告宣傳的 YouTube 影片。 | 
| 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 ( | 
| 欄位 | |
|---|---|
| finalUrl | 
 使用者點按廣告後前往的網頁網址。 | 
| trackingUrl | 
 系統會在背景載入這個網址,以利追蹤。 | 
| actionButtonLabels[] | 
 行動號召按鈕上顯示的文字素材資源清單。 | 
| headlines[] | 
 行動號召橫幅上顯示的廣告標題清單。 | 
| longHeadlines[] | 
 行動號召橫幅上顯示的獨立廣告標題清單。 | 
| descriptions[] | 
 行動號召橫幅上顯示的說明清單。 | 
| displayUrlBreadcrumb1 | 
 顯示網址中網域後的第一個部分。 | 
| displayUrlBreadcrumb2 | 
 顯示網址中網域之後的第二個部分。 | 
| domain | 
 顯示網址的網域。 | 
| videos[] | 
 這則廣告使用的 YouTube 影片素材資源清單。 | 
| customParameters | 
 將自訂值傳送至追蹤網址範本的自訂參數。 這個物件中包含  | 
| companionBanners[] | 
 這個廣告使用的隨播橫幅清單。 | 
AdUrl
與廣告相關的其他網址,包括信號。
| JSON 表示法 | 
|---|
| {
  "type": enum ( | 
| 欄位 | |
|---|---|
| type | 
 廣告網址類型。 | 
| url | 
 網址字串值。 | 
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 的追蹤網址。 | 
| 方法 | |
|---|---|
| 
 | 取得廣告群組廣告。 | 
| 
 | 列出廣告群組廣告。 |