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

必填。廣告的顯示名稱。

必須採用 UTF-8 編碼,大小上限為 255 個位元組。

adPolicy

object (AdPolicy)

僅供輸出。廣告的政策核准狀態。

entityStatus

enum (EntityStatus)

必填。廣告的實體狀態。

adUrls[]

object (AdUrl)

僅供輸出。廣告使用的網址清單。

dcmTrackingInfo

object (DcmTrackingInfo)

(選用步驟) DCM 追蹤廣告資訊。僅適用於需求開發廣告。

如要移除 DCM 追蹤廣告資訊,請將這個欄位留空。

聯集欄位 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)

僅供輸出。影片行動廣告活動中使用的廣告詳細資料,可吸引使用者對商家、服務或產品採取行動。

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

政策主題。

例如「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 主動執行的 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),
  "videoAssetId": string
}
欄位
id

string

僅供輸出。YouTube 影片 ID,可在 YouTube 網頁上搜尋。

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)

要加入追蹤網址的自訂參數和相應值。

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

要加入追蹤網址的自訂參數和相應值。

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

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

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

必填。使用者點按廣告後到達的網頁網址。

trackingUrl

string

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

userSpecifiedTrackingUrl

string

(選用步驟) 使用者手動指定的追蹤網址。

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

(選用步驟) 顯示網址中網域後的第一個部分。

displayUrlBreadcrumb2

string

(選用步驟) 顯示網址中網域之後的第二個部分。

videos[]

object (YoutubeVideoDetails)

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

customParameters

map (key: string, value: string)

(選用步驟) 要加入追蹤網址的自訂參數和相應值。

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

companionBanner

object (ImageAsset)

(選用步驟) 這個廣告使用的隨播橫幅廣告。

finalMobileUrl

string

(選用步驟) 使用者在行動裝置上點選廣告後抵達的網頁網址。

finalUrlSuffix

string

(選用步驟) 要附加至到達網頁網址的尾碼。

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

必填。使用者點按廣告後到達的網頁網址。

trackingUrl

string

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

userSpecifiedTrackingUrl

string

(選用步驟) 使用者手動指定的追蹤網址。

callToAction

string

必填。廣告中顯示的行動號召按鈕。

headlines[]

string

必填。廣告中顯示的標題清單。

descriptions[]

string

必填。廣告中顯示的說明清單。

customParameters

map (key: string, value: string)

(選用步驟) 要加入追蹤網址的自訂參數和相應值。

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

finalMobileUrl

string

(選用步驟) 使用者在行動裝置上點選廣告後抵達的網頁網址。

finalUrlSuffix

string

(選用步驟) 要附加至到達網頁網址的尾碼。

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

必填。使用者點按廣告後到達的網頁網址。

headline

string

必填。廣告標題。

description

string

必填。廣告說明。

cards[]

object (CarouselCard)

必填。廣告中顯示的資訊卡清單。

finalUrlSuffix

string

(選用步驟) 要附加至到達網頁網址的尾碼。

trackingUrl

string

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

userSpecifiedTrackingUrl

string

(選用步驟) 使用者手動指定的追蹤網址。

businessName

string

必填。廣告中顯示的商家名稱。

customParameters

map (key: string, value: string)

(選用步驟) 要加入追蹤網址的自訂參數和相應值。

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

必填。使用者點選資訊卡後前往的網頁網址。

finalMobileUrl

string

(選用步驟) 使用者在行動裝置上點選資訊卡後,所前往網頁的網址。

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

必填。使用者點按廣告後到達的網頁網址。

headline

string

必填。廣告標題。

description

string

必填。廣告說明。

finalUrlSuffix

string

(選用步驟) 要附加至到達網頁網址的尾碼。

callToAction

enum (CallToAction)

必填。廣告中顯示的行動號召按鈕。

支援的值如下:

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

string

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

userSpecifiedTrackingUrl

string

(選用步驟) 使用者手動指定的追蹤網址。

businessName

string

必填。廣告中顯示的商家名稱。

customParameters

map (key: string, value: string)

(選用步驟) 要加入追蹤網址的自訂參數和相應值。

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

displayUrlBreadcrumb1

string

(選用步驟) 顯示網址中網域後的第一個部分。

displayUrlBreadcrumb2

string

(選用步驟) 顯示網址中網域之後的第二個部分。

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 的追蹤網址。

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

更新廣告群組廣告。