- 資源:廣告
- FinalAppUrl
- AppUrlOperatingSystemType
- CustomParameter
- AdType
- 裝置
- UrlCollection
- SystemManagedResourceSource
- TextAdInfo
- ExpandedTextAdInfo
- CallAdInfo
- CallConversionReportingState
- ExpandedDynamicSearchAdInfo
- HotelAdInfo
- ShoppingSmartAdInfo
- ShoppingProductAdInfo
- ImageAdInfo
- MimeType
- AdImageAsset
- VideoAdInfo
- AdVideoAsset
- VideoTrueViewInStreamAdInfo
- VideoBumperInStreamAdInfo
- VideoOutstreamAdInfo
- VideoNonSkippableInStreamAdInfo
- InFeedVideoAdInfo
- VideoThumbnail
- VideoResponsiveAdInfo
- AdTextAsset
- ServedAssetFieldType
- AssetPerformanceLabel
- AdAssetPolicySummary
- PolicyTopicEntry
- PolicyTopicEntryType
- PolicyTopicEvidence
- WebsiteList
- TextList
- DestinationTextList
- DestinationMismatch
- PolicyTopicEvidenceDestinationMismatchUrlType
- DestinationNotWorking
- PolicyTopicEvidenceDestinationNotWorkingDevice
- PolicyTopicEvidenceDestinationNotWorkingDnsErrorType
- PolicyTopicConstraint
- CountryConstraintList
- CountryConstraint
- ResellerConstraint
- PolicyReviewStatus
- PolicyApprovalStatus
- ResponsiveSearchAdInfo
- LegacyResponsiveDisplayAdInfo
- DisplayAdFormatSetting
- AppAdInfo
- AdMediaBundleAsset
- LegacyAppInstallAdInfo
- LegacyAppInstallAdAppStore
- ResponsiveDisplayAdInfo
- ResponsiveDisplayAdControlSpec
- LocalAdInfo
- DisplayUploadAdInfo
- DisplayUploadProductType
- AppEngagementAdInfo
- ShoppingComparisonListingAdInfo
- SmartCampaignAdInfo
- AppPreRegistrationAdInfo
- DiscoveryMultiAssetAdInfo
- DiscoveryCarouselAdInfo
- AdDiscoveryCarouselCardAsset
- DiscoveryVideoResponsiveAdInfo
- AdCallToActionAsset
- DemandGenProductAdInfo
- TravelAdInfo
- 方法
資源:廣告
廣告。
JSON 表示法 |
---|
{ "resourceName": string, "finalUrls": [ string ], "finalAppUrls": [ { object ( |
欄位 | |
---|---|
resourceName |
不可變動。廣告的資源名稱。廣告資源名稱的格式如下:
|
finalUrls[] |
廣告跨網域重新導向的所有可能最終到達網址清單。 |
finalAppUrls[] |
在使用者已安裝特定應用程式時,在行動裝置上使用的最終應用程式網址清單。 |
finalMobileUrls[] |
廣告所有跨網域重新導向後方的可能最終行動版網址清單。 |
urlCustomParameters[] |
可用於替換 |
type |
僅供輸出。廣告類型。 |
devicePreference |
廣告的裝置偏好設定。你只能指定行動裝置的偏好設定。採用這項偏好設定後,在行動裝置上顯示的廣告會優先顯示其他廣告。但還是能在其他類型的裝置上顯示 (舉例來說,沒有其他可放送的廣告時)。如果未指定 (未指定裝置偏好設定),系統會指定所有裝置。只有部分廣告類型支援這項功能。 |
urlCollections[] |
標有專屬 ID 的廣告額外網址 (可從廣告中的其他欄位參照)。 |
systemManagedResourceSource |
僅供輸出。如果這則廣告是由系統管理,這個欄位會指出來源。這是唯讀欄位。 |
id |
僅供輸出。廣告編號。 |
trackingUrlTemplate |
用來建構追蹤網址的網址範本。 |
finalUrlSuffix |
建立最終到達網址時使用的尾碼。 |
displayUrl |
某些廣告格式的廣告說明中顯示的網址。 |
addedByGoogleAds |
僅供輸出。表示這則廣告是否由 Google Ads 自動加入,而非使用者。舉例來說,如果系統根據現有廣告的成效,自動製作廣告做為新廣告建議,可能就會發生這種情況。 |
name |
不可變動。廣告名稱。只能用於辨識廣告。這個名稱可以重複,也不會影響放送的廣告。「名稱」欄位目前僅支援 DisplayUploadAd、ImageAd、ShoppingComparisonListingAd 和 VideoAd。 |
聯集欄位 ad_data 。廣告類型的詳細資料。只能設定一個值。ad_data 只能是下列其中一項: |
|
textAd |
不可變動。文字廣告的相關詳細資料。 |
expandedTextAd |
延展型文字廣告的相關詳細資料。 |
callAd |
與來電廣告相關的詳細資料。 |
expandedDynamicSearchAd |
不可變動。延展型動態搜尋廣告的相關詳情。這類廣告會在放送時自動產生廣告標題、最終到達網址和顯示網址,系統會根據廣告活動層級連結的 |
hotelAd |
飯店廣告的詳細資料。 |
shoppingSmartAd |
智慧購物廣告的詳細資料。 |
shoppingProductAd |
與購物產品廣告相關的詳細資料。 |
imageAd |
不可變動。圖像廣告的相關詳細資料。 |
videoAd |
影片廣告的相關詳細資料。 |
videoResponsiveAd |
影片回應式廣告的詳細資料。 |
responsiveSearchAd |
回應式搜尋廣告的詳細資料。 |
legacyResponsiveDisplayAd |
舊版回應式多媒體廣告的詳細資料。 |
appAd |
與應用程式廣告相關的詳細資料。 |
legacyAppInstallAd |
不可變動。舊版應用程式安裝廣告的相關詳細資料。 |
responsiveDisplayAd |
回應式多媒體廣告的相關詳細資料。 |
localAd |
與區域廣告相關的詳細資料。 |
displayUploadAd |
多媒體廣告上傳廣告的詳細資料。 |
appEngagementAd |
應用程式參與式廣告的相關詳細資料。 |
shoppingComparisonListingAd |
購物比較產品資訊廣告的相關詳細資料。 |
smartCampaignAd |
智慧廣告活動廣告的相關詳細資料。 |
appPreRegistrationAd |
應用程式預先註冊廣告的詳細資料。 |
discoveryMultiAssetAd |
探索多重素材資源廣告的詳細資料。 |
discoveryCarouselAd |
輪轉式探索廣告的詳細資料。 |
discoveryVideoResponsiveAd |
影片回應式廣告的詳細資料。 |
demandGenProductAd |
需求開發產品廣告的詳細資料。 |
travelAd |
旅遊廣告的詳細資料。 |
FinalAppUrl
針對特定作業系統透過應用程式深層連結的網址。
JSON 表示法 |
---|
{
"osType": enum ( |
欄位 | |
---|---|
osType |
這個網址指定的作業系統。這是必填欄位。 |
url |
應用程式深層連結網址。深層連結會指定應用程式中對應您要顯示內容的位置,格式應為 {scheme}://{host_path}。配置可識別要開啟的應用程式。針對應用程式,您可以使用以應用程式名稱開頭的自訂配置。主機和路徑會指定您的內容在應用程式中的專屬位置。例如:「exampleapp://productid_1234」。這是必填欄位。 |
AppUrlOperatingSystemType
作業系統
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
IOS |
Apple IOS 作業系統。 |
ANDROID |
Android 作業系統。 |
CustomParameter
可由 trackingUrlTemplate
、finalUrls
或 mobile_final_urls
中的自訂參數標記使用的對應。
JSON 表示法 |
---|
{ "key": string, "value": string } |
欄位 | |
---|---|
key |
符合參數代碼名稱的鍵。 |
value |
要替換的值。 |
AdType
可能的廣告類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
這個版本無法得知接收到的值。 這個值僅供回應使用。 |
TEXT_AD |
該廣告是文字廣告。 |
EXPANDED_TEXT_AD |
此為延展型文字廣告。 |
EXPANDED_DYNAMIC_SEARCH_AD |
這則廣告是延展型動態搜尋廣告。 |
HOTEL_AD |
廣告是飯店廣告, |
SHOPPING_SMART_AD |
廣告是智慧購物廣告。 |
SHOPPING_PRODUCT_AD |
這是標準購物廣告。 |
VIDEO_AD |
該廣告是影片廣告。 |
IMAGE_AD |
這是圖像廣告。 |
RESPONSIVE_SEARCH_AD |
廣告是回應式搜尋廣告。 |
LEGACY_RESPONSIVE_DISPLAY_AD |
廣告是舊版回應式多媒體廣告。 |
APP_AD |
廣告是應用程式廣告。 |
LEGACY_APP_INSTALL_AD |
這類廣告是舊版應用程式安裝廣告。 |
RESPONSIVE_DISPLAY_AD |
廣告為回應式多媒體廣告。 |
LOCAL_AD |
此為區域廣告。 |
HTML5_UPLOAD_AD |
這個廣告是類型為 HTML5_UPLOAD_AD 產品類型的多媒體廣告上傳廣告。 |
DYNAMIC_HTML5_AD |
這個廣告是多媒體廣告上傳廣告,其中包含其中一種 DYNAMIC_HTML5_* 產品類型。 |
APP_ENGAGEMENT_AD |
這則廣告是應用程式參與式廣告。 |
SHOPPING_COMPARISON_LISTING_AD |
這則廣告是購物比較廣告。 |
VIDEO_BUMPER_AD |
影片串場廣告。 |
VIDEO_NON_SKIPPABLE_IN_STREAM_AD |
不可略過的串流內廣告。 |
VIDEO_OUTSTREAM_AD |
串流外影片廣告。 |
VIDEO_TRUEVIEW_IN_STREAM_AD |
影片 TrueView 串流內廣告。 |
VIDEO_RESPONSIVE_AD |
影片回應式廣告。 |
SMART_CAMPAIGN_AD |
智慧廣告活動廣告。 |
CALL_AD |
來電廣告。 |
APP_PRE_REGISTRATION_AD |
通用應用程式預先註冊廣告。 |
IN_FEED_VIDEO_AD |
動態內影片廣告。 |
DISCOVERY_MULTI_ASSET_AD |
探索多重素材資源廣告。 |
DISCOVERY_CAROUSEL_AD |
輪轉式探索廣告。 |
TRAVEL_AD |
旅遊廣告。 |
DISCOVERY_VIDEO_RESPONSIVE_AD |
影片回應式廣告。 |
DEMAND_GEN_PRODUCT_AD |
需求開發產品廣告, |
裝置
列舉可供指定的 Google Ads 裝置。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
這個版本無法辨識這個值。 |
MOBILE |
配有完整瀏覽器的行動裝置。 |
TABLET |
配有完整瀏覽器的平板電腦。 |
DESKTOP |
電腦。 |
CONNECTED_TV |
智慧型電視和遊戲主機。 |
OTHER |
其他裝置類型。 |
UrlCollection
已標記專屬 ID 的網址集合。
JSON 表示法 |
---|
{ "finalUrls": [ string ], "finalMobileUrls": [ string ], "urlCollectionId": string, "trackingUrlTemplate": string } |
欄位 | |
---|---|
finalUrls[] |
可能的最終到達網址清單。 |
finalMobileUrls[] |
可能的最終行動版網址清單。 |
urlCollectionId |
這個 UrlCollection 例項的專屬 ID。 |
trackingUrlTemplate |
建立追蹤網址的網址範本。 |
SystemManagedResourceSource
列出可能的系統管理實體來源的列舉項目。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
AD_VARIATIONS |
系統產生的廣告變化形式實驗廣告。 |
TextAdInfo
文字廣告。
JSON 表示法 |
---|
{ "headline": string, "description1": string, "description2": string } |
欄位 | |
---|---|
headline |
廣告標題。 |
description1 |
廣告說明的第一行。 |
description2 |
廣告說明的第二行。 |
ExpandedTextAdInfo
延展型文字廣告。
JSON 表示法 |
---|
{ "headlinePart1": string, "headlinePart2": string, "headlinePart3": string, "description": string, "description2": string, "path1": string, "path2": string } |
欄位 | |
---|---|
headlinePart1 |
廣告標題的第一部分。 |
headlinePart2 |
廣告標題的第二部分。 |
headlinePart3 |
廣告標題的第三個部分。 |
description |
廣告的說明。 |
description2 |
廣告的第二個說明。 |
path1 |
顯示在廣告顯示網址旁邊的文字。 |
path2 |
會顯示在顯示網址旁的額外文字。 |
CallAdInfo
來電廣告。
JSON 表示法 |
---|
{
"countryCode": string,
"phoneNumber": string,
"businessName": string,
"headline1": string,
"headline2": string,
"description1": string,
"description2": string,
"callTracked": boolean,
"disableCallConversion": boolean,
"phoneNumberVerificationUrl": string,
"conversionAction": string,
"conversionReportingState": enum ( |
欄位 | |
---|---|
countryCode |
廣告中的國家/地區代碼。 |
phoneNumber |
廣告中的電話號碼。 |
businessName |
廣告中的商家名稱。 |
headline1 |
廣告的第一個廣告標題。 |
headline2 |
廣告的第二行廣告標題。 |
description1 |
廣告說明的第一行。 |
description2 |
廣告說明的第二行。 |
callTracked |
是否要啟用廣告素材的來電追蹤功能。此外,啟用來電追蹤功能也會啟用來電轉換。 |
disableCallConversion |
是否要停用廣告素材的來電轉換。如果設為 |
phoneNumberVerificationUrl |
用於驗證電話號碼的網址。 |
conversionAction |
要將來電轉換歸因於哪個轉換動作。如果未設定,系統就會使用預設轉換動作。這個欄位只會在 |
conversionReportingState |
此來電廣告的來電轉換行為。您可使用自己的來電轉換設定、沿用帳戶層級設定,或停用這項功能。 |
path1 |
可以附加至廣告網址中的文字開頭部分。選用。 |
path2 |
可附加至廣告中網址的第二部分文字。這個欄位只有在已設定 |
CallConversionReportingState
來電轉換動作狀態可能的資料類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
DISABLED |
來電轉換動作已停用。 |
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION |
來電轉換動作將使用在帳戶層級設定的來電轉換類型。 |
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION |
來電轉換動作會使用在資源 (來電廣告/來電額外資訊) 層級設定的來電轉換類型。 |
ExpandedDynamicSearchAdInfo
延展型動態搜尋廣告。
JSON 表示法 |
---|
{ "description": string, "description2": string } |
欄位 | |
---|---|
description |
廣告的說明。 |
description2 |
廣告的第二個說明。 |
HotelAdInfo
這個類型沒有任何欄位。
飯店廣告。
ShoppingSmartAdInfo
這個類型沒有任何欄位。
智慧購物廣告。
ShoppingProductAdInfo
這個類型沒有任何欄位。
標準購物廣告。
ImageAdInfo
圖像廣告。
JSON 表示法 |
---|
{ "mimeType": enum ( |
欄位 | |
---|---|
mimeType |
圖片的 MIME 類型。 |
pixelWidth |
原尺寸圖片的寬度 (以像素為單位)。 |
pixelHeight |
原尺寸圖片的高度 (以像素為單位)。 |
imageUrl |
完整大小圖片的網址。 |
previewPixelWidth |
預覽大小圖片的寬度 (以像素為單位)。 |
previewPixelHeight |
預覽大小圖片的高度 (以像素為單位)。 |
previewImageUrl |
預覽大小圖片的網址。 |
name |
圖片的名稱。如果圖片是透過 MediaFile 建立,這個欄位就會是 MediaFile 的名稱。如果映像檔是從位元組建立,這裡會顯示空白。 |
聯集欄位 image 。要用來建立 ImageAd 的圖片。可透過以下兩種方式指定。1. 現有的 MediaFile 資源。2. 原始圖片資料,以位元組的形式呈現。image 只能是下列其中一項: |
|
imageAsset |
廣告使用的圖片素材資源。 |
data |
原始圖片資料 (以位元組為單位)。 Base64 編碼的字串。 |
adIdToCopyImageFrom |
要複製圖片的廣告 ID。 |
MimeType
MIME 類型
列舉 | |
---|---|
UNSPECIFIED |
尚未指定 MIME 類型。 |
UNKNOWN |
這個版本無法得知接收到的值。 這個值僅供回應使用。 |
IMAGE_JPEG |
圖片/jpeg 的 MIME 類型。 |
IMAGE_GIF |
圖片/GIF 的 MIME 類型。 |
IMAGE_PNG |
圖片/png 的 MIME 類型。 |
FLASH |
應用程式/x-shockwave-flash 的 MIME 類型。 |
TEXT_HTML |
文字/html 的 MIME 類型。 |
PDF |
應用程式/pdf 的 MIME 類型。 |
MSWORD |
應用程式/msword 的 MIME 類型。 |
MSEXCEL |
應用程式/vnd.ms-excel 的 MIME 類型。 |
RTF |
應用程式/rtf 的 MIME 類型。 |
AUDIO_WAV |
音訊/wav 的 MIME 類型。 |
AUDIO_MP3 |
音訊/mp3 的 MIME 類型。 |
HTML5_AD_ZIP |
application/x-html5-ad-zip 的 MIME 類型。 |
AdImageAsset
廣告中使用的圖片素材資源。
JSON 表示法 |
---|
{ "asset": string } |
欄位 | |
---|---|
asset |
這張圖片的資產資源名稱。 |
VideoAdInfo
影片廣告。
JSON 表示法 |
---|
{ "video": { object ( |
欄位 | |
---|---|
video |
廣告使用的 YouTube 影片素材資源。 |
聯集欄位 format 。不同影片格式的專屬結構定義。format 只能是下列其中一項: |
|
inStream |
影片 TrueView 串流內廣告格式。 |
bumper |
影片串場廣告串流內廣告格式。 |
outStream |
串流外影片廣告格式。 |
nonSkippable |
不可略過的串流內廣告格式。 |
inFeed |
動態內影片廣告格式。 |
AdVideoAsset
廣告中使用的影片素材資源。
JSON 表示法 |
---|
{ "asset": string } |
欄位 | |
---|---|
asset |
這部影片的資產資源名稱。 |
VideoTrueViewInStreamAdInfo
代表影片 TrueView 串流內廣告格式 (廣告會在影片播放期間顯示,通常在開始播放時,在影片中顯示略過按鈕幾秒鐘)。
JSON 表示法 |
---|
{
"actionButtonLabel": string,
"actionHeadline": string,
"companionBanner": {
object ( |
欄位 | |
---|---|
actionButtonLabel |
將使用者導向影片廣告的最終到達網址的行動號召 (行動號召) 按鈕標籤。TrueView 行動號召廣告活動必填,否則為選填。 |
actionHeadline |
使用行動號召 (行動號召) 按鈕顯示的額外文字,提供完整說明並鼓勵使用者點選按鈕。 |
companionBanner |
與廣告搭配使用的隨播橫幅廣告圖片素材資源。 |
VideoBumperInStreamAdInfo
代表影片串場廣告格式 (極短的不可略過串流內廣告影片廣告) 的表示法。
JSON 表示法 |
---|
{
"companionBanner": {
object ( |
欄位 | |
---|---|
companionBanner |
與廣告搭配使用的隨播橫幅廣告圖片素材資源。 |
actionButtonLabel |
「行動號召」按鈕上的標籤,會將使用者帶往影片廣告的最終到達網址。 |
actionHeadline |
使用行動號召 (行動號召) 按鈕顯示的額外文字,提供完整說明並鼓勵使用者點選按鈕。 |
VideoOutstreamAdInfo
代表影片串流外廣告格式 (廣告會在有自動播放的動態饋給旁顯示,無聲播放)。
JSON 表示法 |
---|
{ "headline": string, "description": string } |
欄位 | |
---|---|
headline |
廣告標題。 |
description |
說明行。 |
VideoNonSkippableInStreamAdInfo
影片不可略過的串流內廣告格式 (15 秒不可略過的串流內廣告)。
JSON 表示法 |
---|
{
"companionBanner": {
object ( |
欄位 | |
---|---|
companionBanner |
與廣告搭配使用的隨播橫幅廣告圖片素材資源。 |
actionButtonLabel |
「行動號召」按鈕上的標籤,會將使用者帶往影片廣告的最終到達網址。 |
actionHeadline |
包含「行動號召」按鈕的額外文字,可提供說明並鼓勵使用者按下按鈕。 |
InFeedVideoAdInfo
代表動態內影片廣告格式。
JSON 表示法 |
---|
{
"headline": string,
"description1": string,
"description2": string,
"thumbnail": enum ( |
欄位 | |
---|---|
headline |
廣告標題。 |
description1 |
廣告的第一行文字。 |
description2 |
廣告的第二行文字。 |
thumbnail |
要使用的影片縮圖。 |
VideoThumbnail
列出可能的影片縮圖類型。
列舉 | |
---|---|
UNSPECIFIED |
尚未指定類型。 |
UNKNOWN |
這個版本無法得知接收到的值。這個值僅供回應使用。 |
DEFAULT_THUMBNAIL |
預設的縮圖。可自動產生或由使用者上傳。 |
THUMBNAIL_1 |
影片生成的縮圖 1。 |
THUMBNAIL_2 |
影片生成的縮圖 2。 |
THUMBNAIL_3 |
影片生成的縮圖 3。 |
VideoResponsiveAdInfo
影片回應式廣告。
JSON 表示法 |
---|
{ "headlines": [ { object ( |
欄位 | |
---|---|
headlines[] |
用於短廣告標題的文字素材資源清單。目前僅支援一個短廣告標題一個值。 |
longHeadlines[] |
用於長廣告標題的文字素材資源清單。目前僅支援長標題的單一值。 |
descriptions[] |
用於說明的文字素材資源清單。目前僅支援一個說明值。 |
callToActions[] |
用於按鈕的文字素材資源清單,例如「行動號召」按鈕。目前,該按鈕僅支援一個值。 |
videos[] |
廣告使用的 YouTube 影片素材資源清單。目前僅支援一個 YouTube 影片素材資源的值。 |
companionBanners[] |
用於隨播橫幅廣告的圖片素材資源清單。目前,隨播橫幅廣告素材資源僅支援一個值。 |
breadcrumb1 |
與顯示網址相符的廣告開頭文字。 |
breadcrumb2 |
廣告與顯示網址的第二部分文字。 |
AdTextAsset
廣告中使用的文字素材資源。
JSON 表示法 |
---|
{ "pinnedField": enum ( |
欄位 | |
---|---|
pinnedField |
素材資源的固定欄位。這樣一來,素材資源就只會在這個欄位中放送。多個素材資源可固定至同一欄位。如果素材資源已取消固定或固定至其他欄位,則不會顯示已固定其他素材資源的欄位。 |
assetPerformanceLabel |
這個文字素材資源的成效標籤。 |
policySummaryInfo |
這個文字素材資源的政策摘要。 |
text |
素材資源文字。 |
ServedAssetFieldType
可能的素材資源欄位類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
這個版本無法得知接收到的值。 這個值僅供回應使用。 |
HEADLINE_1 |
素材資源用於廣告標題 1。 |
HEADLINE_2 |
素材資源用於廣告標題 2。 |
HEADLINE_3 |
素材資源用於廣告標題 3。 |
DESCRIPTION_1 |
素材資源在說明 1 中使用。 |
DESCRIPTION_2 |
素材資源在說明 2 中使用。 |
HEADLINE |
廣告標題中使用了這項素材資源。只有在廣告只有一個廣告標題時,才適用這個方法。否則,請使用 HEADLINE_1、HEADLINE_2 或 HEADLINE_3 列舉。 |
HEADLINE_IN_PORTRAIT |
這個素材資源已做為直向圖片的標題。 |
LONG_HEADLINE |
素材資源用於長廣告標題 (用於 MultiAssetResponsiveAd)。 |
DESCRIPTION |
這項素材資源已在說明中使用。除非廣告只有一則說明,否則請使用這項屬性。否則,請使用 DESCRIPTION_1 或 DESCRIPTION_@ 列舉 |
DESCRIPTION_IN_PORTRAIT |
這項素材資源在直向圖片中當做說明使用。 |
BUSINESS_NAME_IN_PORTRAIT |
這個素材資源在直向圖片中當做商家名稱。 |
BUSINESS_NAME |
素材資源已當做商家名稱。 |
MARKETING_IMAGE |
這項素材資源是行銷圖片。 |
MARKETING_IMAGE_IN_PORTRAIT |
這項素材資源是直向圖片的行銷圖片。 |
SQUARE_MARKETING_IMAGE |
這項素材資源是用於正方形行銷圖片。 |
PORTRAIT_MARKETING_IMAGE |
這項素材資源是直向行銷圖片。 |
LOGO |
素材資源已做為標誌使用。 |
LANDSCAPE_LOGO |
素材資源是橫向標誌。 |
CALL_TO_ACTION |
這個素材資源可做為行動號召。 |
YOU_TUBE_VIDEO |
該項資產當做 YouTube 影片使用。 |
SITELINK |
這項素材資源會做為網站連結。 |
CALL |
這個素材資源會用於呼叫。 |
MOBILE_APP |
這個素材資源可做為行動應用程式。 |
CALLOUT |
這項素材資源會做為摘要使用。 |
STRUCTURED_SNIPPET |
這個素材資源可做為網站簡介使用。 |
PRICE |
這個素材資源是用於價格。 |
PROMOTION |
這項素材資源用於促銷。 |
AD_IMAGE |
這個素材資源會做為圖片使用。 |
LEAD_FORM |
素材資源可做為待開發客戶表單。 |
BUSINESS_LOGO |
素材資源會做為商家標誌。 |
AssetPerformanceLabel
說明資產可能的效能標籤,通常根據連結情境計算。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
PENDING |
這項素材資源還沒有任何成效資訊。這可能是因為該項內容仍在審查中。 |
LEARNING |
該素材資源已開始獲得曝光,但統計資料的統計顯著性不足,無法取得素材資源成效標籤。 |
LOW |
成效最差的素材資源。 |
GOOD |
成效良好的素材資源。 |
BEST |
成效最佳的素材資源。 |
AdAssetPolicySummary
包含廣告內素材資源的政策資訊。
JSON 表示法 |
---|
{ "policyTopicEntries": [ { object ( |
欄位 | |
---|---|
policyTopicEntries[] |
這項資產的政策發現項目清單。 |
reviewStatus |
這項素材資源處於審查階段的哪個階段。 |
approvalStatus |
這項素材資源的整體核准狀態,根據個別政策主題項目的狀態計算而得。 |
PolicyTopicEntry
資源附加的政策結果 (例如與銷售酒精飲料網站相關聯的酒精飲料政策)。
每個 PolicyTopicEntry 都有一個主題,用來指出該項目相關的特定廣告政策,以及指出該項目將對廣告放送的影響的類型。可能的依據包括一或多個能指出發現項目原因的證據。您也可選擇設定一或多項限制,詳細說明廣告放送受限的方式。
JSON 表示法 |
---|
{ "type": enum ( |
欄位 | |
---|---|
type |
說明這項政策對廣告放送的負面或正面影響。 |
evidences[] |
解釋政策發現結果的其他資訊 (例如商標發現項目的品牌名稱)。 |
constraints[] |
說明這項資源的供應方式會受到哪些影響 (例如未在特定國家/地區放送)。 |
topic |
這個發現項目所參照的政策主題。例如「ALCOHOL」、「TRADEMARKS_IN_AD_TEXT」或「DESTINATION_NOT_WORKING」。特定 API 版本的可能政策主題組合並不固定,而且隨時可能變更。 |
PolicyTopicEntryType
可能的政策主題項目類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
這個版本無法得知接收到的值。 這個值僅供回應使用。 |
PROHIBITED |
系統不會提供資源。 |
LIMITED |
在某些情況下,提供資源將無法使用。 |
FULLY_LIMITED |
受到目前的指定條件影響,這項資源完全無法放送。 |
DESCRIPTIVE |
可能會感興趣,但不會限制資源的提供方式。 |
BROADENING |
提高涵蓋率可超出正常範圍。 |
AREA_OF_INTEREST_ONLY |
限制所有指定國家/地區,但可在其他國家/地區根據感興趣的區域放送。 |
PolicyTopicEvidence
說明政策發現項目的其他資訊。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 value 。根據證據類型提供的特定證據資訊。value 只能是下列其中一項: |
|
websiteList |
與這項資源連結的網站清單。 |
textList |
在資源文字中找到的證據清單。 |
languageCode |
系統偵測到資源的寫入語言。此為 IETF 語言代碼,例如「en-US」。 |
destinationTextList |
造成政策發現項目的資源目的地文字。 |
destinationMismatch |
資源網址目的地不相符。 |
destinationNotWorking |
針對常用裝置傳回 HTTP 錯誤代碼,或未在所有地區正常運作的詳細資料。 |
WebsiteList
導致政策判定結果的網站清單。適用於 ONE_WEBSITE_PER_AD_GROUP 政策主題,例如。如果出現超過五個網站,這裡只會列出前五名 (最常出現在資源中的網站) 的網站。
JSON 表示法 |
---|
{ "websites": [ string ] } |
欄位 | |
---|---|
websites[] |
違反政策的網站。 |
TextList
違反政策的文字片段清單。
JSON 表示法 |
---|
{ "texts": [ string ] } |
欄位 | |
---|---|
texts[] |
導致政策發現項目的資源文字片段。 |
DestinationTextList
在到達網頁中找到導致政策發現項目的字串清單。
JSON 表示法 |
---|
{ "destinationTexts": [ string ] } |
欄位 | |
---|---|
destinationTexts[] |
在資源目的地頁面找到的文字清單。 |
DestinationMismatch
資源網址之間不相符的證據。
JSON 表示法 |
---|
{
"urlTypes": [
enum ( |
欄位 | |
---|---|
urlTypes[] |
一組不相符的網址。 |
PolicyTopicEvidenceDestinationMismatchUrlType
可能的政策主題指出到達網頁的網址類型不符。
列舉 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
這個版本無法得知接收到的值。 這個值僅供回應使用。 |
DISPLAY_URL |
顯示網址。 |
FINAL_URL |
最終到達網址。 |
FINAL_MOBILE_URL |
最終行動版網址。 |
TRACKING_URL |
追蹤網址範本,已替換電腦版網址。 |
MOBILE_TRACKING_URL |
追蹤網址範本,已替換的行動版網址。 |
DestinationNotWorking
目的地傳回 HTTP 錯誤代碼,或未在常用裝置正常運作的證明詳細資料。
JSON 表示法 |
---|
{ "device": enum ( |
欄位 | |
---|---|
device |
無法載入網址的裝置類型。 |
expandedUrl |
完整版網址無效。 |
lastCheckedDateTime |
上次檢查網址的時間。格式為「YYYY-MM-DD HH:MM:SS」。範例:「2018-03-05 09:15:00」或「2018-02-01 14:34:30」 |
聯集欄位 reason 。指出找到「DESTINATION_NOT_WORKING」政策的原因。reason 只能是下列其中一項: |
|
dnsErrorType |
DNS 錯誤類型。 |
httpErrorCode |
HTTP 錯誤代碼。 |
PolicyTopicEvidenceDestinationNotWorkingDevice
可能的政策主題導致目的地無效。
列舉 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
這個版本無法得知接收到的值。 這個值僅供回應使用。 |
DESKTOP |
到達網頁無法在電腦裝置上運作。 |
ANDROID |
到達網頁無法在 Android 裝置上運作。 |
IOS |
到達網頁無法在 iOS 裝置上運作。 |
PolicyTopicEvidenceDestinationNotWorkingDnsErrorType
可能的政策主題,證實目的地無效。
列舉 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
這個版本無法得知接收到的值。 這個值僅供回應使用。 |
HOSTNAME_NOT_FOUND |
擷取到達網頁時,DNS 中找不到主機名稱。 |
GOOGLE_CRAWLER_DNS_ISSUE |
Google 內部檢索器與 DNS 通訊時發生的問題。這項錯誤不代表到達網頁無法運作,Google 會重新檢索到達網頁。 |
PolicyTopicConstraint
說明提供政策主題項目將造成的影響。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 value 。限制相關的具體資訊。value 只能是下列其中一項: |
|
countryConstraintList |
無法使用資源的國家/地區。 |
resellerConstraint |
經銷商限制。 |
certificateMissingInCountryList |
必須提供認證才能放送影片的國家/地區。 |
certificateDomainMismatchInCountryList |
資源的網域不在相關憑證涵蓋範圍內。 |
CountryConstraintList
資源供應受限的國家/地區清單。
JSON 表示法 |
---|
{
"countries": [
{
object ( |
欄位 | |
---|---|
countries[] |
廣告放送功能受限的國家/地區。 |
totalTargetedCountries |
資源指定的國家/地區總數。 |
CountryConstraint
表示某項資源在特定國家/地區的供應能力受到限制。
JSON 表示法 |
---|
{ "countryCriterion": string } |
欄位 | |
---|---|
countryCriterion |
廣告放送受限國家/地區的指定地理區域常數資源名稱。 |
ResellerConstraint
這個類型沒有任何欄位。
表示因經銷商要求拒登網站,導致政策主題受到限制。
PolicyReviewStatus
可能的政策審核狀態。
列舉 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
這個版本無法得知接收到的值。 這個值僅供回應使用。 |
REVIEW_IN_PROGRESS |
目前正在審查中。 |
REVIEWED |
已完成主要審查。系統可能會繼續審查其他評論。 |
UNDER_APPEAL |
這項資源已重新送交審核,或是已對政策裁決提出申訴。 |
ELIGIBLE_MAY_SERVE |
資源符合資格且可能可供放送,但仍可接受進一步審查。 |
PolicyApprovalStatus
可能的政策核准狀態。有多個核准狀態時,系統會使用最嚴重的核准狀態。嚴重性的順序為 DISAPPROVED、AREA_OF_INTEREST_ONLY、APPROVED_LIMITED 和 APPROVED。
列舉 | |
---|---|
UNSPECIFIED |
未指定任何值。 |
UNKNOWN |
這個版本無法得知接收到的值。 這個值僅供回應使用。 |
DISAPPROVED |
將不會放送。 |
APPROVED_LIMITED |
放送設有限制。 |
APPROVED |
放送不受限制。 |
AREA_OF_INTEREST_ONLY |
不會在指定國家/地區放送,但可能會向搜尋指定國家/地區相關資訊的使用者放送。 |
ResponsiveSearchAdInfo
回應式搜尋廣告。
回應式搜尋廣告會靈活調整廣告內容,讓客戶能看到更多文字及更切合需求的訊息。製作回應式搜尋廣告時,您只要輸入多則廣告標題和說明,Google Ads 就會自動測試各種不同的組合,逐漸找出成效最佳者。回應式搜尋廣告會自行調整廣告內容,更貼近潛在顧客的搜尋字詞,因此能夠提升廣告活動成效。
JSON 表示法 |
---|
{ "headlines": [ { object ( |
欄位 | |
---|---|
headlines[] |
廣告標題文字素材資源清單。廣告放送時,系統會從這份清單中選取廣告標題。 |
descriptions[] |
說明文字素材資源清單。廣告放送時,就會從這份清單中選取。 |
path1 |
可以附加至廣告網址中的文字開頭部分。 |
path2 |
可附加至廣告中網址的第二部分文字。這個欄位只有在已設定 |
LegacyResponsiveDisplayAdInfo
舊版回應式多媒體廣告。這類廣告會在 Google Ads 使用者介面中標示為「回應式廣告」。
JSON 表示法 |
---|
{
"formatSetting": enum ( |
欄位 | |
---|---|
formatSetting |
指定廣告放送的格式。預設值為 ALL_FORMATS。 |
shortHeadline |
廣告標題的簡短版本。 |
longHeadline |
廣告標題的長版本。 |
description |
廣告的說明。 |
businessName |
廣告中的商家名稱。 |
allowFlexibleColor |
廣告主同意允許彈性顏色。如果為 true,廣告可能會在必要時使用不同顏色。如果為 false,廣告會以指定顏色或中性色放送。預設值為 |
accentColor |
廣告的強調色以十六進位表示,例如 #ffffff 代表白色。如果設定了 |
mainColor |
廣告的主要顏色,以十六進位表示,例如 #ffffff 代表白色。如果設定了 |
callToActionText |
廣告的行動號召文字。 |
logoImage |
廣告所用標誌圖片的 MediaFile 資源名稱。 |
squareLogoImage |
廣告所用正方形標誌圖片的 MediaFile 資源名稱。 |
marketingImage |
廣告所宣傳行銷圖片的 MediaFile 資源名稱。 |
squareMarketingImage |
廣告所用正方形行銷圖片的 MediaFile 資源名稱。 |
pricePrefix |
價格前的前置字串。例如「最低價格」。 |
promoText |
用於回應式廣告動態格式的宣傳文字。例如「免費兩天內送達」。 |
DisplayAdFormatSetting
列舉多媒體廣告格式設定。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
這個版本無法辨識這個值。 |
ALL_FORMATS |
文字、圖像和原生格式。 |
NON_NATIVE |
文字和圖片格式。 |
NATIVE |
舉例來說,原生格式的顯示格式是由發布商控管,而非 Google。 |
AppAdInfo
應用程式廣告。
JSON 表示法 |
---|
{ "mandatoryAdText": { object ( |
欄位 | |
---|---|
mandatoryAdText |
必要廣告文字。 |
headlines[] |
廣告標題文字素材資源清單。廣告放送時,系統會從這份清單中選取廣告標題。 |
descriptions[] |
說明文字素材資源清單。廣告放送時,就會從這份清單中選取。 |
images[] |
可隨廣告一起顯示的圖片素材資源清單。 |
youtubeVideos[] |
可與廣告一併顯示的 YouTube 影片素材資源清單。 |
html5MediaBundles[] |
可能與廣告搭配使用的媒體組合素材資源清單。 |
AdMediaBundleAsset
廣告中使用的媒體組合素材資源。
JSON 表示法 |
---|
{ "asset": string } |
欄位 | |
---|---|
asset |
此媒體組合的素材資源資源名稱。 |
LegacyAppInstallAdInfo
僅限少數特定客戶使用的舊版應用程式安裝廣告。
JSON 表示法 |
---|
{
"appStore": enum ( |
欄位 | |
---|---|
appStore |
行動應用程式已推出至應用程式商店。 |
appId |
行動應用程式的 ID。 |
headline |
廣告標題。 |
description1 |
廣告的第一行說明。 |
description2 |
廣告的第二行說明。 |
LegacyAppInstallAdAppStore
舊版應用程式安裝廣告中的應用程式商店類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本未知的值。 |
APPLE_APP_STORE |
Apple iTunes。 |
GOOGLE_PLAY |
Google Play |
WINDOWS_STORE |
Windows 市集。 |
WINDOWS_PHONE_STORE |
Windows Phone Store。 |
CN_APP_STORE |
應用程式由中國應用程式商店代管。 |
ResponsiveDisplayAdInfo
回應式多媒體廣告。
JSON 表示法 |
---|
{ "marketingImages": [ { object ( |
欄位 | |
---|---|
marketingImages[] |
要在廣告中使用的行銷圖片。有效的圖片類型為 GIF、JPEG 和 PNG。大小下限為 600x314,顯示比例必須為 1.91:1 (+-1%)。至少須提供一個 |
squareMarketingImages[] |
要在廣告中使用的正方形行銷圖片。有效的圖片類型為 GIF、JPEG 和 PNG。大小下限為 300x300,顯示比例必須為 1:1 (+-1%)。至少要有一個正方形 |
logoImages[] |
要在廣告中使用的標誌圖片。有效的圖片類型為 GIF、JPEG 和 PNG。大小下限為 512x128,顯示比例必須為 4:1 (+-1%)。搭配 |
squareLogoImages[] |
要在廣告中使用的正方形標誌圖片。有效的圖片類型為 GIF、JPEG 和 PNG。大小下限為 128x128,顯示比例必須為 1:1 (+-1%)。搭配 |
headlines[] |
廣告的短版標題。長度上限為 30 個半形字元。至少可以指定 1 個廣告標題 (最多 5 個)。 |
longHeadline |
必填的長廣告標題。長度上限為 90 個半形字元。 |
descriptions[] |
廣告的說明文字。長度上限為 90 個半形字元。至少可以指定 1 個廣告標題 (最多 5 個)。 |
youtubeVideos[] |
廣告的選用 YouTube 影片。最多可以指定 5 部影片。 |
formatSetting |
指定廣告放送的格式。預設值為 ALL_FORMATS。 |
controlSpec |
各種廣告素材控制選項規格。 |
businessName |
廣告主/品牌名稱。螢幕寬度上限為 25。 |
mainColor |
廣告的主要顏色,以十六進位表示,例如 #ffffff 代表白色。如果設定了 |
accentColor |
廣告的強調色以十六進位表示,例如 #ffffff 代表白色。如果設定了 |
allowFlexibleColor |
廣告主同意允許彈性顏色。如果為 true,廣告可能會在必要時使用不同顏色。如果為 false,廣告會以指定顏色或中性色放送。預設值為 |
callToActionText |
廣告的行動號召文字。螢幕寬度上限為 30。 |
pricePrefix |
價格前的前置字串。例如「最低價格」。 |
promoText |
用於回應式廣告動態格式的宣傳文字。例如「免費兩天內送達」。 |
ResponsiveDisplayAdControlSpec
回應式多媒體廣告的各種廣告素材控制項規格。
JSON 表示法 |
---|
{ "enableAssetEnhancements": boolean, "enableAutogenVideo": boolean } |
欄位 | |
---|---|
enableAssetEnhancements |
廣告主是否選擇使用素材資源強化功能。 |
enableAutogenVideo |
廣告主是否選擇採用自動產生影片功能。 |
LocalAdInfo
區域廣告。
JSON 表示法 |
---|
{ "headlines": [ { object ( |
欄位 | |
---|---|
headlines[] |
廣告標題文字素材資源清單。廣告放送時,系統會從這份清單中選取廣告標題。至少須指定 1 個,最多 5 個。 |
descriptions[] |
說明文字素材資源清單。廣告放送時,就會從這份清單中選取。至少須指定 1 則說明 (最多 5 則)。 |
callToActions[] |
行動號召文字素材資源清單。放送廣告時,系統會從這份清單中選取行動號召。至少必須指定 1 個和 5 個行動號召。 |
marketingImages[] |
可與廣告一併顯示的行銷圖片素材資源清單。圖片必須是 314x600 像素或 320x320 像素。至少須指定 1 項圖片素材資源,最多 20 項。 |
logoImages[] |
可與廣告一併顯示的標誌圖片素材資源清單。圖片的大小必須為 128x128 像素,且不得超過 120 KB。至少須指定 1 項圖片素材資源,最多 5 項。 |
videos[] |
可與廣告一併顯示的 YouTube 影片素材資源清單。至少須指定 1 項影片素材資源,最多 20 項。 |
path1 |
第一部分可選文字,可以附加到廣告中的網址。 |
path2 |
第二部分可選文字,可附加到廣告中的網址。這個欄位只有在已設定 |
DisplayUploadAdInfo
通用的多媒體廣告。確切的廣告格式由 displayUploadProductType
欄位控制,該欄位會決定廣告需要納入的資料類型。
JSON 表示法 |
---|
{ "displayUploadProductType": enum ( |
欄位 | |
---|---|
displayUploadProductType |
此廣告的產品類型。詳情請參閱列舉的註解。 |
聯集欄位 media_asset 。組成廣告的素材資源資料。media_asset 只能是下列其中一項: |
|
mediaBundle |
要在廣告中使用的媒體組合素材資源。如要進一步瞭解 HTML5_UPLOAD_AD 的媒體組合,請參閱https://support.google.com/google-ads/answer/1722096屬於動態產品類型的媒體組合使用必須透過 Google Web Designer 建立的特殊格式。詳情請參閱 https://support.google.com/webdesigner/answer/7543898。 |
DisplayUploadProductType
列舉顯示上傳產品類型。
列舉 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
這個版本無法辨識這個值。 |
HTML5_UPLOAD_AD |
上傳 HTML5 廣告。必須設定 DisplayUploadAdInfo 中的 upload_media_bundle 欄位,才能使用這個產品類型。 |
DYNAMIC_HTML5_EDUCATION_AD |
動態 HTML5 教育廣告。必須設定 DisplayUploadAdInfo 中的 upload_media_bundle 欄位,才能使用這個產品類型。只能用於教育廣告活動。 |
DYNAMIC_HTML5_FLIGHT_AD |
動態 HTML5 檔期廣告。必須設定 DisplayUploadAdInfo 中的 upload_media_bundle 欄位,才能使用這個產品類型。只能用於檔期廣告活動。 |
DYNAMIC_HTML5_HOTEL_RENTAL_AD |
動態 HTML5 飯店和租賃廣告。必須設定 DisplayUploadAdInfo 中的 upload_media_bundle 欄位,才能使用這個產品類型。只能用於飯店廣告活動。 |
DYNAMIC_HTML5_JOB_AD |
動態 HTML5 工作機會廣告。必須設定 DisplayUploadAdInfo 中的 upload_media_bundle 欄位,才能使用這個產品類型。只能用於工作活動廣告活動。 |
DYNAMIC_HTML5_LOCAL_AD |
動態 HTML5 區域廣告。必須設定 DisplayUploadAdInfo 中的 upload_media_bundle 欄位,才能使用這個產品類型。只能用於地區廣告活動。 |
DYNAMIC_HTML5_REAL_ESTATE_AD |
動態 HTML5 房地產廣告。必須設定 DisplayUploadAdInfo 中的 upload_media_bundle 欄位,才能使用這個產品類型。只能用於房地產廣告活動。 |
DYNAMIC_HTML5_CUSTOM_AD |
動態 HTML5 自訂廣告。必須設定 DisplayUploadAdInfo 中的 upload_media_bundle 欄位,才能使用這個產品類型。只能用於自訂廣告活動。 |
DYNAMIC_HTML5_TRAVEL_AD |
動態 HTML5 旅遊廣告。必須設定 DisplayUploadAdInfo 中的 upload_media_bundle 欄位,才能使用這個產品類型。只能用於旅遊廣告活動。 |
DYNAMIC_HTML5_HOTEL_AD |
動態 HTML5 飯店廣告。必須設定 DisplayUploadAdInfo 中的 upload_media_bundle 欄位,才能使用這個產品類型。只能用於飯店廣告活動。 |
AppEngagementAdInfo
應用程式參與式廣告可讓您撰寫文字,鼓勵使用者在應用程式中採取特定動作,例如報到、購物或預訂航班。這種廣告可將使用者帶往您應用程式的特定部分,讓他們更輕鬆快速地找到所需內容。
JSON 表示法 |
---|
{ "headlines": [ { object ( |
欄位 | |
---|---|
headlines[] |
廣告標題文字素材資源清單。廣告放送時,系統會從這份清單中選取廣告標題。 |
descriptions[] |
說明文字素材資源清單。廣告放送時,就會從這份清單中選取。 |
images[] |
可隨廣告一起顯示的圖片素材資源清單。 |
videos[] |
可隨廣告一起顯示的影片素材資源清單。 |
ShoppingComparisonListingAdInfo
購物比較資訊廣告。
JSON 表示法 |
---|
{ "headline": string } |
欄位 | |
---|---|
headline |
廣告的標題。這是必填欄位。允許的長度介於 25 到 45 個字元之間。 |
SmartCampaignAdInfo
智慧廣告活動的廣告。
JSON 表示法 |
---|
{ "headlines": [ { object ( |
欄位 | |
---|---|
headlines[] |
文字素材資源清單,每個素材資源都會對應廣告放送時的標題。這份清單包含至少 3 至 15 項文字素材資源。 |
descriptions[] |
文字素材資源清單,每個素材資源都會對應廣告放送時的說明。這份清單包含至少 2 到 4 個文字素材資源。 |
AppPreRegistrationAdInfo
應用程式預先註冊廣告可以連結到 Google Play 上的應用程式或遊戲資訊,可在 Google Play、YouTube (僅限串流內廣告) 以及多媒體廣告聯播網的其他應用程式和行動網站上放送。這麼做可引起使用者對應用程式或遊戲的興趣,讓應用程式或遊戲在上市前獲得一定的安裝基礎。
JSON 表示法 |
---|
{ "headlines": [ { object ( |
欄位 | |
---|---|
headlines[] |
廣告標題文字素材資源清單。廣告放送時,系統會從這份清單中選取廣告標題。 |
descriptions[] |
說明文字素材資源清單。廣告放送時,就會從這份清單中選取。 |
images[] |
圖片素材資源 ID 的清單,其圖片可能會與廣告一起顯示。 |
youtubeVideos[] |
YouTube 影片資產 ID 清單,其中的影片可能會與廣告一併顯示。 |
DiscoveryMultiAssetAdInfo
探索多重素材資源廣告。
JSON 表示法 |
---|
{ "marketingImages": [ { object ( |
欄位 | |
---|---|
marketingImages[] |
要在廣告中使用的行銷圖片素材資源。有效的圖片類型為 GIF、JPEG 和 PNG。大小下限為 600x314,顯示比例必須為 1.91:1 (+-1%)。如果沒有 SquareMarketingImages,則為必要欄位。與 |
squareMarketingImages[] |
要在廣告中使用的正方形行銷圖片素材資源。有效的圖片類型為 GIF、JPEG 和 PNG。大小下限為 300x300,顯示比例必須為 1:1 (+-1%)。如果缺少行銷圖片,則為必要欄位。與 |
portraitMarketingImages[] |
要在廣告中使用的直向行銷圖片素材資源。有效的圖片類型為 GIF、JPEG 和 PNG。大小下限為 480x600,顯示比例必須為 4:5 (+-1%)。與 |
logoImages[] |
要在廣告中使用的標誌圖片素材資源。有效的圖片類型為 GIF、JPEG 和 PNG。大小下限為 128x128,顯示比例必須為 1:1 (+-1%)。至少可以指定 1 張標誌圖片,最多 5 張。 |
headlines[] |
廣告的廣告標題文字素材資源。螢幕寬度上限為 30。至少可以指定 1 個廣告標題 (最多 5 個)。 |
descriptions[] |
廣告的說明文字。螢幕寬度上限為 90。至少指定 1 則說明 (最多 5 則)。 |
businessName |
廣告主/品牌名稱。螢幕寬度上限為 25。這是必填欄位。 |
callToActionText |
行動號召文字。 |
leadFormOnly |
布林值選項,指出廣告是否需要待開發客戶表單放送。 |
DiscoveryCarouselAdInfo
輪轉式探索廣告。
JSON 表示法 |
---|
{ "businessName": string, "logoImage": { object ( |
欄位 | |
---|---|
businessName |
必要欄位。廣告主/品牌名稱。 |
logoImage |
必要欄位。要在廣告中使用的標誌圖片。大小下限為 128x128,顯示比例必須為 1:1 (+-1%)。 |
headline |
必要欄位。廣告標題。 |
description |
必要欄位。廣告的說明文字。 |
callToActionText |
行動號召文字。 |
carouselCards[] |
必要欄位。伴隨廣告一同顯示的輪轉資訊卡。最少 2,最多 10。 |
AdDiscoveryCarouselCardAsset
廣告中使用的輪轉式探索廣告資訊卡素材資源。
JSON 表示法 |
---|
{ "asset": string } |
欄位 | |
---|---|
asset |
這張探索廣告輪轉介面資訊卡的資產資源名稱。 |
DiscoveryVideoResponsiveAdInfo
影片探索廣告。
JSON 表示法 |
---|
{ "headlines": [ { object ( |
欄位 | |
---|---|
headlines[] |
用於短廣告標題的文字素材資源清單。 |
longHeadlines[] |
用於長廣告標題的文字素材資源清單。 |
descriptions[] |
用於說明的文字素材資源清單。 |
videos[] |
廣告使用的 YouTube 影片素材資源清單。 |
logoImages[] |
要在廣告中使用的標誌圖片。有效的圖片類型為 GIF、JPEG 和 PNG。大小下限為 128x128,顯示比例必須為 1:1 (+-1%)。 |
breadcrumb1 |
與顯示網址相符的廣告開頭文字。 |
breadcrumb2 |
廣告與顯示網址的第二部分文字。 |
businessName |
必要欄位。廣告主/品牌名稱。 |
callToActions[] |
用於「行動號召」按鈕的 CallToActionAsset 類型的素材資源。 |
AdCallToActionAsset
廣告中使用的行動號召素材資源。
JSON 表示法 |
---|
{ "asset": string } |
欄位 | |
---|---|
asset |
此行動號召素材資源的素材資源資源名稱。 |
DemandGenProductAdInfo
需求開發產品廣告。
JSON 表示法 |
---|
{ "breadcrumb1": string, "breadcrumb2": string, "businessName": { object ( |
欄位 | |
---|---|
breadcrumb1 |
與顯示網址相符的廣告開頭文字。 |
breadcrumb2 |
廣告與顯示網址的第二部分文字。 |
businessName |
必要欄位。廣告主/品牌名稱。 |
headline |
必要欄位。用於短廣告標題的文字素材資源。 |
description |
必要欄位。用於說明的文字素材資源。 |
logoImage |
必要欄位。要在廣告中使用的標誌圖片。有效的圖片類型為 GIF、JPEG 和 PNG。大小下限為 128x128,顯示比例必須為 1:1 (+-1%)。 |
callToAction |
用於「行動號召」按鈕的 CallToActionAsset 類型素材資源。 |
TravelAdInfo
這個類型沒有任何欄位。
旅遊廣告。
方法 |
|
---|---|
|
傳回請求的廣告完整詳情。 |
|
更新廣告。 |