- 資源: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 的追蹤網址。 | 
方法 | 
            |
|---|---|
                
 | 
              取得廣告群組廣告。 | 
                
 | 
              列出廣告群組廣告。 |