- 資源:AdGroupAd
- DisplayVideoSourceAd
- MastheadAd
- YoutubeVideoDetails
- VideoUnavailableReason
- VideoAspectRatio
- InStreamAd
- CommonInStreamAttribute
- ImageAsset
- NonSkippableAd
- BumperAd
- AudioAd
- VideoDiscoveryAd
- 縮圖
- VideoPerformanceAd
- DemandGenVideoAd
- CallToAction
- DemandGenImageAd
- DemandGenCarouselAd
- CarouselCard
- DemandGenProductAd
- 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
- AdUrl
- AdUrlType
- DcmTrackingInfo
- 方法
資源: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[] |
僅供輸出。廣告使用的網址清單。 |
dcmTrackingInfo |
(選用步驟) DCM 追蹤廣告資訊。僅適用於需求開發廣告。 如要移除 DCM 追蹤廣告資訊,請將這個欄位留空。 |
| 廣告詳情。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位: | |
displayVideoSourceAd |
僅供輸出。Display & Video 360 廣告素材來源廣告的詳細資料。 |
mastheadAd |
僅供輸出。在 YouTube 首頁動態放送的廣告詳細資料。 |
inStreamAd |
僅供輸出。5 秒後可略過的串流內廣告詳細資料,用於品牌知名度或觸及率行銷目標。 |
nonSkippableAd |
僅供輸出。不可略過的短串流內影片廣告詳細資料,長度介於 6 到 15 秒,用於觸及行銷目標。 |
bumperAd |
僅供輸出。不可略過的短片廣告詳細資料,長度不超過 6 秒,用於觸及。 |
audioAd |
僅供輸出。用於觸及行銷目標的音訊廣告詳細資料。 |
videoDiscoverAd |
僅供輸出。宣傳影片的廣告詳細資料,這類廣告會顯示在探索位置。 |
videoPerformanceAd |
僅供輸出。影片行動廣告活動中使用的廣告詳細資料,用於吸引使用者對商家、服務或產品採取行動。 |
demandGenVideoAd |
需求開發影片廣告的詳細資料。 |
demandGenImageAd |
需求開發圖像廣告詳情。 |
demandGenCarouselAd |
需求開發輪轉廣告詳細資料。 |
demandGenProductAd |
需求開發產品廣告詳細資料。 |
| 互斥欄位結束。 | |
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 |
無法取得影片資料的原因。 |
videoAssetId |
|
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 |
僅供輸出。圖片素材資源的檔案大小 (以位元組為單位)。 |
assetId |
必填。素材資源的專屬 ID。 |
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[] |
這個廣告使用的隨播橫幅廣告清單。 |
businessName |
(選用步驟) 廣告中顯示的商家名稱。 除非已在廣告主層級設定預設值,否則必須指定這項設定。如未設定,系統會套用預設值。 |
logo |
(選用步驟) 這個廣告使用的標誌圖片。 除非已在廣告主層級設定預設值,否則必須指定這項設定。如未設定,系統會套用預設值。 |
DemandGenVideoAd
需求開發影片廣告的詳細資料。
| JSON 表示法 |
|---|
{ "finalUrl": string, "trackingUrl": string, "userSpecifiedTrackingUrl": string, "callToAction": enum ( |
| 欄位 | |
|---|---|
finalUrl |
必填。使用者點按廣告後,所前往網頁的網址。 |
trackingUrl |
僅供輸出。在背景載入的網址,用於追蹤。 |
userSpecifiedTrackingUrl |
(選用步驟) 使用者手動指定的追蹤網址。 |
callToAction |
必填。廣告上顯示的行動號召按鈕。 支援的值如下:
|
headlines[] |
必填。廣告中顯示的廣告標題清單。 |
longHeadlines[] |
必填。廣告顯示的長標題清單。 |
descriptions[] |
必填。廣告中顯示的說明清單。 |
displayUrlBreadcrumb1 |
(選用步驟) 顯示網址中網域後方的第一個部分。 |
displayUrlBreadcrumb2 |
(選用步驟) 顯示網址中網域後方的第二個部分。 |
videos[] |
必填。這個廣告使用的 YouTube 影片素材資源清單。 |
customParameters |
(選用步驟) 要新增至追蹤網址的自訂參數和隨附值。 這個物件中包含 |
companionBanner |
(選用步驟) 這個廣告使用的隨播橫幅廣告。 |
logo |
(選用步驟) 這個廣告使用的標誌圖片。 除非已在廣告主層級設定預設值,否則必須指定這項設定。如未設定,系統會套用預設值。 |
finalMobileUrl |
(選用步驟) 使用者在行動裝置上點按廣告後,所前往網頁的網址。 |
finalUrlSuffix |
(選用步驟) 要附加到到達網頁網址的尾碼。 |
businessName |
(選用步驟) 廣告中顯示的商家名稱。 除非已在廣告主層級設定預設值,否則必須指定這項設定。如未設定,系統會套用預設值。 |
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 ( |
| 欄位 | |
|---|---|
finalUrl |
必填。使用者點按廣告後,所前往網頁的網址。 |
trackingUrl |
僅供輸出。在背景載入的網址,用於追蹤。 |
userSpecifiedTrackingUrl |
(選用步驟) 使用者手動指定的追蹤網址。 |
callToAction |
必填。廣告上顯示的行動號召按鈕。 |
headlines[] |
必填。廣告中顯示的廣告標題清單。 |
descriptions[] |
必填。廣告中顯示的說明清單。 |
customParameters |
(選用步驟) 要新增至追蹤網址的自訂參數和隨附值。 這個物件中包含 |
finalMobileUrl |
(選用步驟) 使用者在行動裝置上點按廣告後,所前往網頁的網址。 |
finalUrlSuffix |
(選用步驟) 要附加到到達網頁網址的尾碼。 |
businessName |
(選用步驟) 廣告中顯示的商家名稱。 除非已在廣告主層級設定預設值,否則必須指定這項設定。如未設定,系統會套用預設值。 |
marketingImages[] |
廣告中顯示的行銷圖片清單。 |
squareMarketingImages[] |
廣告中顯示的正方形行銷圖片清單。 |
portraitMarketingImages[] |
廣告中顯示的直向行銷圖片清單。 |
logoImages[] |
廣告中顯示的標誌圖片清單。 除非已在廣告主層級設定預設值,否則必須指定這項設定。如未設定,系統會套用預設值。 |
DemandGenCarouselAd
需求開發輪轉廣告的詳細資料。
| JSON 表示法 |
|---|
{ "finalUrl": string, "headline": string, "description": string, "cards": [ { object ( |
| 欄位 | |
|---|---|
finalUrl |
必填。使用者點按廣告後,所前往網頁的網址。 |
headline |
必填。廣告標題。 |
description |
必填。廣告說明。 |
cards[] |
必填。廣告中顯示的資訊卡清單。 |
finalUrlSuffix |
(選用步驟) 要附加到到達網頁網址的尾碼。 |
trackingUrl |
僅供輸出。在背景載入的網址,用於追蹤。 |
userSpecifiedTrackingUrl |
(選用步驟) 使用者手動指定的追蹤網址。 |
businessName |
(選用步驟) 廣告中顯示的商家名稱。 除非已在廣告主層級設定預設值,否則必須指定這項設定。如未設定,系統會套用預設值。 |
customParameters |
(選用步驟) 要新增至追蹤網址的自訂參數和隨附值。 這個物件中包含 |
logo |
(選用步驟) 這個廣告使用的標誌圖片。 除非已在廣告主層級設定預設值,否則必須指定這項設定。如未設定,系統會套用預設值。 |
CarouselCard
需求開發輪轉介面資訊卡的詳細資料。
| JSON 表示法 |
|---|
{ "finalUrl": string, "finalMobileUrl": string, "headline": string, "callToAction": string, "marketingImage": { object ( |
| 欄位 | |
|---|---|
finalUrl |
必填。使用者點按資訊卡後,所前往網頁的網址。 |
finalMobileUrl |
(選用步驟) 使用者在行動裝置上點按資訊卡後,所前往網頁的網址。 |
headline |
必填。資訊卡的廣告標題。 |
callToAction |
必填。資訊卡上行動號召按鈕顯示的文字。 不得超過 10 個字元。 |
marketingImage |
(選用步驟) 資訊卡上顯示的行銷圖片。 |
squareMarketingImage |
(選用步驟) 資訊卡上顯示的正方形行銷圖片。 |
portraitMarketingImage |
(選用步驟) 資訊卡上顯示的直向行銷圖片。 |
DemandGenProductAd
需求開發產品廣告的詳細資料。
| JSON 表示法 |
|---|
{ "finalUrl": string, "headline": string, "description": string, "finalUrlSuffix": string, "callToAction": enum ( |
| 欄位 | |
|---|---|
finalUrl |
必填。使用者點按廣告後,所前往網頁的網址。 |
headline |
必填。廣告標題。 |
description |
必填。廣告說明。 |
finalUrlSuffix |
(選用步驟) 要附加到到達網頁網址的尾碼。 |
callToAction |
必填。廣告上顯示的行動號召按鈕。 支援的值如下:
|
trackingUrl |
僅供輸出。在背景載入的網址,用於追蹤。 |
userSpecifiedTrackingUrl |
(選用步驟) 使用者手動指定的追蹤網址。 |
businessName |
(選用步驟) 廣告中顯示的商家名稱。 除非已在廣告主層級設定預設值,否則必須指定這項設定。如未設定,系統會套用預設值。 |
customParameters |
(選用步驟) 要新增至追蹤網址的自訂參數和隨附值。 這個物件中包含 |
logo |
(選用步驟) 這個廣告使用的標誌圖片。 除非已在廣告主層級設定預設值,否則必須指定這項設定。如未設定,系統會套用預設值。 |
displayUrlBreadcrumb1 |
(選用步驟) 顯示網址中網域後方的第一個部分。 |
displayUrlBreadcrumb2 |
(選用步驟) 顯示網址中網域後方的第二個部分。 |
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 表示法 |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "textList": { object ( |
| 欄位 | |
|---|---|
| 政策裁決的證據。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位: | |
textList |
在廣告文字中找到的證據清單。 |
websiteList |
與廣告連結的網站清單。 |
httpCode |
檢索最終到達網址時傳回的 HTTP 代碼。 |
languageCode |
系統偵測到的廣告語言。 這個欄位使用 IETF 語言標記,例如「en-US」。 |
destinationTextList |
廣告到達網頁中違反政策的文字。 |
destinationMismatch |
廣告到達網頁網址不一致。 |
destinationNotWorking |
與廣告到達網頁相關的 HTTP 或 DNS 錯誤資訊。 |
trademark |
違反政策的商標字詞。 |
legalRemoval |
因法律相關法規執行而違反政策。 |
counterfeit |
因違反仿冒商品政策而受到的違規處置。 |
regionalRequirements |
信任與安全團隊主動執行違規處置,導致違反政策。 |
| 互斥欄位結束。 | |
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」以外的偏移量。範例: |
| HTTP 或 DNS 錯誤。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位: | |
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 |
Google 與 DNS 通訊時,無法檢索到達網頁。 |
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[] |
因依法移除而受限的網址。 |
| 依法移除類型的詳細資料。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位: | |
dmca |
《數位千禧年著作權法》(DMCA) 依法移除規定的詳細資料。 |
localLegal |
當地法律法規依法移除的詳細資料。 |
| 互斥欄位結束。 | |
數位千禧年著作權法 (DMCA)
DMCA 申訴詳細資料。
| JSON 表示法 |
|---|
{ "complainant": string } |
| 欄位 | |
|---|---|
complainant |
提出法律申訴的實體。 |
LocalLegal
當地法律法規詳細資料。
| JSON 表示法 |
|---|
{ "lawType": string } |
| 欄位 | |
|---|---|
lawType |
法律聲明的法律類型。 |
AdPolicyTopicEvidenceLegalRemovalComplaintType
依法移除要求可能涉及的申訴類型。
| 列舉 | |
|---|---|
AD_POLICY_TOPIC_EVIDENCE_LEGAL_REMOVAL_COMPLAINT_TYPE_UNKNOWN |
未指定或不明。 |
COPYRIGHT |
版權。 僅適用於 DMCA。 |
COURT_ORDER |
法院命令。 僅適用於當地法律。 |
LOCAL_LEGAL |
當地法律規範。 僅適用於當地法律。 |
仿冒商品
仿冒商品違規處置詳情。
| JSON 表示法 |
|---|
{ "owners": [ string ] } |
| 欄位 | |
|---|---|
owners[] |
提出申訴的內容或產品擁有者。 |
RegionalRequirements
信任與安全團隊主動執行政策,因應區域法規要求。這屬於 Google 主導的調查,而非監管通知,因為這是主動執行的信任與安全違規處置。
| JSON 表示法 |
|---|
{
"regionalRequirementsEntries": [
{
object ( |
| 欄位 | |
|---|---|
regionalRequirementsEntries[] |
區域規定清單。 |
RegionalRequirementsEntry
政策層級區域法律違規詳情。
| JSON 表示法 |
|---|
{
"legalPolicy": string,
"countryRestrictions": [
{
object ( |
| 欄位 | |
|---|---|
legalPolicy |
違反的法律政策。 |
countryRestrictions[] |
因法律政策而受限的國家/地區。 |
AdPolicyTopicConstraint
廣告放送限制的詳細資料。
| JSON 表示法 |
|---|
{ "requestCertificateFormLink": string, // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "countryConstraint": { object ( |
| 欄位 | |
|---|---|
requestCertificateFormLink |
表單連結,用於要求限制憑證。 |
| 放送限制。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位: | |
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 |
您可以使用申訴表單對裁決提出申訴。 |
AdUrl
與廣告相關的其他網址,包括信標。
| JSON 表示法 |
|---|
{
"type": enum ( |
| 欄位 | |
|---|---|
type |
廣告網址類型。 |
url |
網址字串值。 |
AdUrlType
可能的廣告網址類型。
| 列舉 | |
|---|---|
AD_URL_TYPE_UNSPECIFIED |
不明或未指定。 |
AD_URL_TYPE_BEACON_IMPRESSION |
廣告素材曝光時,系統會對 1x1 追蹤像素發出連線偵測 (ping)。 |
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 |
必填。DCM 刊登位置 ID。 |
trackingAdId |
必填。DCM 追蹤廣告 ID。 |
creativeId |
必填。DCM 廣告素材 ID。 |
方法 |
|
|---|---|
|
建立廣告群組廣告。 |
|
刪除廣告群組廣告。 |
|
取得廣告群組廣告。 |
|
列出廣告群組廣告。 |
|
更新廣告群組廣告。 |