REST Resource: customers.ads

FinalAppUrl

針對特定作業系統透過應用程式深層連結的網址。

JSON 表示法 
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
欄位
osType

enum (AppUrlOperatingSystemType)

這個網址指定的作業系統。這是必填欄位。
url

string

應用程式深層連結網址。深層連結會指定應用程式中對應您要顯示內容的位置，格式應為 {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

string

符合參數代碼名稱的鍵。
value

string

要替換的值。

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 探索多重素材資源廣告。
TRAVEL_AD 旅遊廣告。
DISCOVERY_VIDEO_RESPONSIVE_AD 影片回應式廣告。

裝置

列舉可供指定的 Google Ads 裝置。

列舉
UNSPECIFIED 未指定。
UNKNOWN 這個版本無法辨識這個值。
MOBILE 配有完整瀏覽器的行動裝置。
TABLET 配有完整瀏覽器的平板電腦。
DESKTOP 電腦。
CONNECTED_TV 智慧型電視和遊戲主機。
OTHER 其他裝置類型。

UrlCollection

已標記專屬 ID 的網址集合。

JSON 表示法 
{
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCollectionId": string,
  "trackingUrlTemplate": string
}
欄位
finalUrls[]

string

可能的最終到達網址清單。
finalMobileUrls[]

string

可能的最終行動版網址清單。
urlCollectionId

string

這個 UrlCollection 例項的專屬 ID。
trackingUrlTemplate

string

建立追蹤網址的網址範本。

SystemManagedResourceSource

列出可能的系統管理實體來源的列舉項目。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
AD_VARIATIONS 系統產生的廣告變化形式實驗廣告。

TextAdInfo

文字廣告。

JSON 表示法 
{
  "headline": string,
  "description1": string,
  "description2": string
}
欄位
headline

string

廣告標題。
description1

string

廣告說明的第一行。
description2

string

廣告說明的第二行。

ExpandedTextAdInfo

延展型文字廣告。

JSON 表示法 
{
  "headlinePart1": string,
  "headlinePart2": string,
  "headlinePart3": string,
  "description": string,
  "description2": string,
  "path1": string,
  "path2": string
}
欄位
headlinePart1

string

廣告標題的第一部分。
headlinePart2

string

廣告標題的第二部分。
headlinePart3

string

廣告標題的第三個部分。
description

string

廣告的說明。
description2

string

廣告的第二個說明。
path1

string

顯示在廣告顯示網址旁邊的文字。
path2

string

會顯示在顯示網址旁的額外文字。

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 (CallConversionReportingState),
  "path1": string,
  "path2": string
}
欄位
countryCode

string

廣告中的國家/地區代碼。
phoneNumber

string

廣告中的電話號碼。
businessName

string

廣告中的商家名稱。
headline1

string

廣告的第一個廣告標題。
headline2

string

廣告的第二行廣告標題。
description1

string

廣告說明的第一行。
description2

string

廣告說明的第二行。
callTracked

boolean

是否要啟用廣告素材的來電追蹤功能。此外，啟用來電追蹤功能也會啟用來電轉換。
disableCallConversion

boolean

是否要停用廣告素材的來電轉換。如果設為 true，則即使 callTracked 為 true，仍會停用來電轉換。如果 callTracked 為 false，系統會忽略這個欄位。
phoneNumberVerificationUrl

string

用於驗證電話號碼的網址。
conversionAction

string

要將來電轉換歸因於哪個轉換動作。如果未設定，系統就會使用預設轉換動作。這個欄位只會在 callTracked 設為 true 時生效。否則系統會忽略這個欄位。
conversionReportingState

enum (CallConversionReportingState)

此來電廣告的來電轉換行為。您可使用自己的來電轉換設定、沿用帳戶層級設定，或停用這項功能。
path1

string

可以附加至廣告網址中的文字開頭部分。選用。
path2

string

可附加至廣告中網址的第二部分文字。這個欄位只有在已設定 path1 時才能設定。選用。

CallConversionReportingState

來電轉換動作狀態可能的資料類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
DISABLED 來電轉換動作已停用。
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION 來電轉換動作將使用在帳戶層級設定的來電轉換類型。
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION 來電轉換動作會使用在資源 (來電廣告/來電額外資訊) 層級設定的來電轉換類型。

ExpandedDynamicSearchAdInfo

延展型動態搜尋廣告。

JSON 表示法 
{
  "description": string,
  "description2": string
}
欄位
description

string

廣告的說明。
description2

string

廣告的第二個說明。

HotelAdInfo

這個類型沒有任何欄位。

飯店廣告。

ShoppingSmartAdInfo

這個類型沒有任何欄位。

智慧購物廣告。

ShoppingProductAdInfo

這個類型沒有任何欄位。

標準購物廣告。

ImageAdInfo

圖像廣告。

JSON 表示法 
{
  "mimeType": enum (MimeType),
  "pixelWidth": string,
  "pixelHeight": string,
  "imageUrl": string,
  "previewPixelWidth": string,
  "previewPixelHeight": string,
  "previewImageUrl": string,
  "name": string,

  // Union field image can be only one of the following:
  "mediaFile": string,
  "data": string,
  "adIdToCopyImageFrom": string
  // End of list of possible types for union field image.
}
欄位
mimeType

enum (MimeType)

圖片的 MIME 類型。
pixelWidth

string (int64 format)

原尺寸圖片的寬度 (以像素為單位)。
pixelHeight

string (int64 format)

原尺寸圖片的高度 (以像素為單位)。
imageUrl

string

完整大小圖片的網址。
previewPixelWidth

string (int64 format)

預覽大小圖片的寬度 (以像素為單位)。
previewPixelHeight

string (int64 format)

預覽大小圖片的高度 (以像素為單位)。
previewImageUrl

string

預覽大小圖片的網址。
name

string

圖片的名稱。如果圖片是透過 MediaFile 建立，這個欄位就會是 MediaFile 的名稱。如果映像檔是從位元組建立，這裡會顯示空白。
聯集欄位 image。要用來建立 ImageAd 的圖片。可透過以下兩種方式指定。1. 現有的 MediaFile 資源。2. 原始圖片資料，以位元組的形式呈現。image 只能是下列其中一項：
mediaFile

string

要用於圖片的 MediaFile 資源。
data

string (bytes format)

原始圖片資料 (以位元組為單位)。

Base64 編碼的字串。
adIdToCopyImageFrom

string (int64 format)

要複製圖片的廣告 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 類型。

VideoAdInfo

影片廣告。

JSON 表示法 
{
  "video": {
    object (AdVideoAsset)
  },

  // Union field format can be only one of the following:
  "inStream": {
    object (VideoTrueViewInStreamAdInfo)
  },
  "bumper": {
    object (VideoBumperInStreamAdInfo)
  },
  "outStream": {
    object (VideoOutstreamAdInfo)
  },
  "nonSkippable": {
    object (VideoNonSkippableInStreamAdInfo)
  },
  "inFeed": {
    object (InFeedVideoAdInfo)
  }
  // End of list of possible types for union field format.
}
欄位
video

object (AdVideoAsset)

廣告使用的 YouTube 影片素材資源。
聯集欄位 format。不同影片格式的專屬結構定義。format 只能是下列其中一項：
inStream

object (VideoTrueViewInStreamAdInfo)

影片 TrueView 串流內廣告格式。
bumper

object (VideoBumperInStreamAdInfo)

影片串場廣告串流內廣告格式。
outStream

object (VideoOutstreamAdInfo)

串流外影片廣告格式。
nonSkippable

object (VideoNonSkippableInStreamAdInfo)

不可略過的串流內廣告格式。
inFeed

object (InFeedVideoAdInfo)

動態內影片廣告格式。

AdVideoAsset

廣告中使用的影片素材資源。

JSON 表示法 
{
  "asset": string
}
欄位
asset

string

這部影片的資產資源名稱。

VideoTrueViewInStreamAdInfo

代表影片 TrueView 串流內廣告格式 (廣告會在影片播放期間顯示，通常在開始播放時，在影片中顯示略過按鈕幾秒鐘)。

JSON 表示法 
{
  "actionButtonLabel": string,
  "actionHeadline": string,
  "companionBanner": {
    object (AdImageAsset)
  }
}
欄位
actionButtonLabel

string

將使用者導向影片廣告的最終到達網址的行動號召 (行動號召) 按鈕標籤。TrueView 行動號召廣告活動必填，否則為選填。
actionHeadline

string

使用行動號召 (行動號召) 按鈕顯示的額外文字，提供完整說明並鼓勵使用者點選按鈕。
companionBanner

object (AdImageAsset)

與廣告搭配使用的隨播橫幅廣告圖片素材資源。

AdImageAsset

廣告中使用的圖片素材資源。

JSON 表示法 
{
  "asset": string
}
欄位
asset

string

這張圖片的資產資源名稱。

VideoBumperInStreamAdInfo

代表影片串場廣告格式 (極短的不可略過串流內廣告影片廣告) 的表示法。

JSON 表示法 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
欄位
companionBanner

object (AdImageAsset)

與廣告搭配使用的隨播橫幅廣告圖片素材資源。
actionButtonLabel

string

「行動號召」按鈕上的標籤，會將使用者帶往影片廣告的最終到達網址。
actionHeadline

string

使用行動號召 (行動號召) 按鈕顯示的額外文字，提供完整說明並鼓勵使用者點選按鈕。

VideoOutstreamAdInfo

代表影片串流外廣告格式 (廣告會在有自動播放的動態饋給旁顯示，無聲播放)。

JSON 表示法 
{
  "headline": string,
  "description": string
}
欄位
headline

string

廣告標題。
description

string

說明行。

VideoNonSkippableInStreamAdInfo

影片不可略過的串流內廣告格式 (15 秒不可略過的串流內廣告)。

JSON 表示法 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
欄位
companionBanner

object (AdImageAsset)

與廣告搭配使用的隨播橫幅廣告圖片素材資源。
actionButtonLabel

string

「行動號召」按鈕上的標籤，會將使用者帶往影片廣告的最終到達網址。
actionHeadline

string

包含「行動號召」按鈕的額外文字，可提供說明並鼓勵使用者按下按鈕。

InFeedVideoAdInfo

代表動態內影片廣告格式。

JSON 表示法 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "thumbnail": enum (VideoThumbnail)
}
欄位
headline

string

廣告標題。
description1

string

廣告的第一行文字。
description2

string

廣告的第二行文字。
thumbnail

enum (VideoThumbnail)

要使用的影片縮圖。

VideoThumbnail

列出可能的影片縮圖類型。

列舉
UNSPECIFIED 尚未指定類型。
UNKNOWN 這個版本無法得知接收到的值。這個值僅供回應使用。
DEFAULT_THUMBNAIL 預設的縮圖。可自動產生或由使用者上傳。
THUMBNAIL_1 影片生成的縮圖 1。
THUMBNAIL_2 影片生成的縮圖 2。
THUMBNAIL_3 影片生成的縮圖 3。

VideoResponsiveAdInfo

影片回應式廣告。

JSON 表示法 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "companionBanners": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string
}
欄位
headlines[]

object (AdTextAsset)

用於短廣告標題的文字素材資源清單。目前僅支援一個短廣告標題一個值。
longHeadlines[]

object (AdTextAsset)

用於長廣告標題的文字素材資源清單。目前僅支援長標題的單一值。
descriptions[]

object (AdTextAsset)

用於說明的文字素材資源清單。目前僅支援一個說明值。
callToActions[]

object (AdTextAsset)

用於按鈕的文字素材資源清單，例如「行動號召」按鈕。目前，該按鈕僅支援一個值。
videos[]

object (AdVideoAsset)

廣告使用的 YouTube 影片素材資源清單。目前僅支援一個 YouTube 影片素材資源的值。
companionBanners[]

object (AdImageAsset)

用於隨播橫幅廣告的圖片素材資源清單。目前，隨播橫幅廣告素材資源僅支援一個值。
breadcrumb1

string

與顯示網址相符的廣告開頭文字。
breadcrumb2

string

廣告與顯示網址的第二部分文字。

AdTextAsset

廣告中使用的文字素材資源。

JSON 表示法 
{
  "pinnedField": enum (ServedAssetFieldType),
  "assetPerformanceLabel": enum (AssetPerformanceLabel),
  "policySummaryInfo": {
    object (AdAssetPolicySummary)
  },
  "text": string
}
欄位
pinnedField

enum (ServedAssetFieldType)

素材資源的固定欄位。這樣一來，素材資源就只會在這個欄位中放送。多個素材資源可固定至同一欄位。如果素材資源已取消固定或固定至其他欄位，則不會顯示已固定其他素材資源的欄位。
assetPerformanceLabel

enum (AssetPerformanceLabel)

這個文字素材資源的成效標籤。
policySummaryInfo

object (AdAssetPolicySummary)

這個文字素材資源的政策摘要。
text

string

素材資源文字。

ServedAssetFieldType

可能的素材資源欄位類型。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN

這個版本無法得知接收到的值。

這個值僅供回應使用。
HEADLINE_1 素材資源用於廣告標題 1。
HEADLINE_2 素材資源用於廣告標題 2。
HEADLINE_3 素材資源用於廣告標題 3。
DESCRIPTION_1 素材資源在說明 1 中使用。
DESCRIPTION_2 素材資源在說明 2 中使用。
CALL 這個素材資源會用於呼叫。
MOBILE_APP 這個素材資源可做為行動應用程式。
CALLOUT 這項素材資源會做為摘要使用。
STRUCTURED_SNIPPET 這個素材資源可做為網站簡介使用。
PRICE 這個素材資源是用於價格。
PROMOTION 這項素材資源用於促銷。
AD_IMAGE 這個素材資源會做為圖片使用。
LEAD_FORM 素材資源可做為待開發客戶表單。

AssetPerformanceLabel

說明資產可能的效能標籤，通常根據連結情境計算。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
PENDING 這項素材資源還沒有任何成效資訊。這可能是因為該項內容仍在審查中。
LEARNING 該素材資源已開始獲得曝光，但統計資料的統計顯著性不足，無法取得素材資源成效標籤。
LOW 成效最差的素材資源。
GOOD 成效良好的素材資源。
BEST 成效最佳的素材資源。

AdAssetPolicySummary

包含廣告內素材資源的政策資訊。

JSON 表示法 
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
欄位
policyTopicEntries[]

object (PolicyTopicEntry)

這項資產的政策發現項目清單。
reviewStatus

enum (PolicyReviewStatus)

這項素材資源處於審查階段的哪個階段。
approvalStatus

enum (PolicyApprovalStatus)

這項素材資源的整體核准狀態，根據個別政策主題項目的狀態計算而得。

PolicyTopicEntry

資源附加的政策結果 (例如與銷售酒精飲料網站相關聯的酒精飲料政策)。

每個 PolicyTopicEntry 都有一個主題，用來指出該項目相關的特定廣告政策，以及指出該項目將對廣告放送的影響的類型。可能的依據包括一或多個能指出發現項目原因的證據。您也可選擇設定一或多項限制，詳細說明廣告放送受限的方式。

JSON 表示法 
{
  "type": enum (PolicyTopicEntryType),
  "evidences": [
    {
      object (PolicyTopicEvidence)
    }
  ],
  "constraints": [
    {
      object (PolicyTopicConstraint)
    }
  ],
  "topic": string
}
欄位
type

enum (PolicyTopicEntryType)

說明這項政策對廣告放送的負面或正面影響。
evidences[]

object (PolicyTopicEvidence)

解釋政策發現結果的其他資訊 (例如商標發現項目的品牌名稱)。
constraints[]

object (PolicyTopicConstraint)

說明這項資源的供應方式會受到哪些影響 (例如未在特定國家/地區放送)。
topic

string

這個發現項目所參照的政策主題。例如「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 can be only one of the following:
  "websiteList": {
    object (WebsiteList)
  },
  "textList": {
    object (TextList)
  },
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  }
  // End of list of possible types for union field value.
}
欄位
聯集欄位 value。根據證據類型提供的特定證據資訊。value 只能是下列其中一項：
websiteList

object (WebsiteList)

與這項資源連結的網站清單。
textList

object (TextList)

在資源文字中找到的證據清單。
languageCode

string

系統偵測到資源的寫入語言。此為 IETF 語言代碼，例如「en-US」。
destinationTextList

object (DestinationTextList)

造成政策發現項目的資源目的地文字。
destinationMismatch

object (DestinationMismatch)

資源網址目的地不相符。
destinationNotWorking

object (DestinationNotWorking)

針對常用裝置傳回 HTTP 錯誤代碼，或未在所有地區正常運作的詳細資料。

WebsiteList

導致政策判定結果的網站清單。適用於 ONE_WEBSITE_PER_AD_GROUP 政策主題，例如。如果出現超過五個網站，這裡只會列出前五名 (最常出現在資源中的網站) 的網站。

JSON 表示法 
{
  "websites": [
    string
  ]
}
欄位
websites[]

string

違反政策的網站。

TextList

違反政策的文字片段清單。

JSON 表示法 
{
  "texts": [
    string
  ]
}
欄位
texts[]

string

導致政策發現項目的資源文字片段。

DestinationTextList

在到達網頁中找到導致政策發現項目的字串清單。

JSON 表示法 
{
  "destinationTexts": [
    string
  ]
}
欄位
destinationTexts[]

string

在資源目的地頁面找到的文字清單。

DestinationMismatch

資源網址之間不相符的證據。

JSON 表示法 
{
  "urlTypes": [
    enum (PolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
欄位
urlTypes[]

enum (PolicyTopicEvidenceDestinationMismatchUrlType)

一組不相符的網址。

PolicyTopicEvidenceDestinationMismatchUrlType

可能的政策主題指出到達網頁的網址類型不符。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN

這個版本無法得知接收到的值。

這個值僅供回應使用。
DISPLAY_URL 顯示網址。
FINAL_URL 最終到達網址。
FINAL_MOBILE_URL 最終行動版網址。
TRACKING_URL 追蹤網址範本，已替換電腦版網址。
MOBILE_TRACKING_URL 追蹤網址範本，已替換的行動版網址。

DestinationNotWorking

目的地傳回 HTTP 錯誤代碼，或未在常用裝置正常運作的證明詳細資料。

JSON 表示法 
{
  "device": enum (PolicyTopicEvidenceDestinationNotWorkingDevice),
  "expandedUrl": string,
  "lastCheckedDateTime": string,

  // Union field reason can be only one of the following:
  "dnsErrorType": enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of list of possible types for union field reason.
}
欄位
device

enum (PolicyTopicEvidenceDestinationNotWorkingDevice)

無法載入網址的裝置類型。
expandedUrl

string

完整版網址無效。
lastCheckedDateTime

string

上次檢查網址的時間。格式為「YYYY-MM-DD HH:MM:SS」。範例：「2018-03-05 09:15:00」或「2018-02-01 14:34:30」
聯集欄位 reason。指出找到「DESTINATION_NOT_WORKING」政策的原因。reason 只能是下列其中一項：
dnsErrorType

enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

DNS 錯誤類型。
httpErrorCode

string (int64 format)

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 can be only one of the following:
  "countryConstraintList": {
    object (CountryConstraintList)
  },
  "resellerConstraint": {
    object (ResellerConstraint)
  },
  "certificateMissingInCountryList": {
    object (CountryConstraintList)
  },
  "certificateDomainMismatchInCountryList": {
    object (CountryConstraintList)
  }
  // End of list of possible types for union field value.
}
欄位
聯集欄位 value。限制相關的具體資訊。value 只能是下列其中一項：
countryConstraintList

object (CountryConstraintList)

無法使用資源的國家/地區。
resellerConstraint

object (ResellerConstraint)

經銷商限制。
certificateMissingInCountryList

object (CountryConstraintList)

必須提供認證才能放送影片的國家/地區。
certificateDomainMismatchInCountryList

object (CountryConstraintList)

資源的網域不在相關憑證涵蓋範圍內。

CountryConstraintList

資源供應受限的國家/地區清單。

JSON 表示法 
{
  "countries": [
    {
      object (CountryConstraint)
    }
  ],
  "totalTargetedCountries": integer
}
欄位
countries[]

object (CountryConstraint)

廣告放送功能受限的國家/地區。
totalTargetedCountries

integer

資源指定的國家/地區總數。

CountryConstraint

表示某項資源在特定國家/地區的供應能力受到限制。

JSON 表示法 
{
  "countryCriterion": string
}
欄位
countryCriterion

string

廣告放送受限國家/地區的指定地理區域常數資源名稱。

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 就會自動測試各種不同的組合，逐漸找出成效最佳者。回應式搜尋廣告會自行調整廣告內容，更貼近潛在顧客的搜尋字詞，因此能夠提升廣告活動成效。

詳情請參閱：https://support.google.com/google-ads/answer/7684791

JSON 表示法 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string
}
欄位
headlines[]

object (AdTextAsset)

廣告標題文字素材資源清單。廣告放送時，系統會從這份清單中選取廣告標題。
descriptions[]

object (AdTextAsset)

說明文字素材資源清單。廣告放送時，就會從這份清單中選取。
path1

string

可以附加至廣告網址中的文字開頭部分。
path2

string

可附加至廣告中網址的第二部分文字。這個欄位只有在已設定 path1 時才能設定。

LegacyResponsiveDisplayAdInfo

舊版回應式多媒體廣告。這類廣告會在 Google Ads 使用者介面中標示為「回應式廣告」。

JSON 表示法 
{
  "formatSetting": enum (DisplayAdFormatSetting),
  "shortHeadline": string,
  "longHeadline": string,
  "description": string,
  "businessName": string,
  "allowFlexibleColor": boolean,
  "accentColor": string,
  "mainColor": string,
  "callToActionText": string,
  "logoImage": string,
  "squareLogoImage": string,
  "marketingImage": string,
  "squareMarketingImage": string,
  "pricePrefix": string,
  "promoText": string
}
欄位
formatSetting

enum (DisplayAdFormatSetting)

指定廣告放送的格式。預設值為 ALL_FORMATS。
shortHeadline

string

廣告標題的簡短版本。
longHeadline

string

廣告標題的長版本。
description

string

廣告的說明。
businessName

string

廣告中的商家名稱。
allowFlexibleColor

boolean

廣告主同意允許彈性顏色。如果為 true，廣告可能會在必要時使用不同顏色。如果為 false，廣告會以指定顏色或中性色放送。預設值為 true。如未設定 mainColor 和 accentColor，則必須設為 true。
accentColor

string

廣告的強調色以十六進位表示，例如 #ffffff 代表白色。如果設定了 mainColor 和 accentColor 其中之一，必須一併設定另一個。
mainColor

string

廣告的主要顏色，以十六進位表示，例如 #ffffff 代表白色。如果設定了 mainColor 和 accentColor 其中之一，必須一併設定另一個。
callToActionText

string

廣告的行動號召文字。
logoImage

string

廣告所用標誌圖片的 MediaFile 資源名稱。
squareLogoImage

string

廣告所用正方形標誌圖片的 MediaFile 資源名稱。
marketingImage

string

廣告所宣傳行銷圖片的 MediaFile 資源名稱。
squareMarketingImage

string

廣告所用正方形行銷圖片的 MediaFile 資源名稱。
pricePrefix

string

價格前的前置字串。例如「最低價格」。
promoText

string

用於回應式廣告動態格式的宣傳文字。例如「免費兩天內送達」。

DisplayAdFormatSetting

列舉多媒體廣告格式設定。

列舉
UNSPECIFIED 未指定。
UNKNOWN 這個版本無法辨識這個值。
ALL_FORMATS 文字、圖像和原生格式。
NON_NATIVE 文字和圖片格式。
NATIVE 舉例來說，原生格式的顯示格式是由發布商控管，而非 Google。

AppAdInfo

應用程式廣告。

JSON 表示法 
{
  "mandatoryAdText": {
    object (AdTextAsset)
  },
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "html5MediaBundles": [
    {
      object (AdMediaBundleAsset)
    }
  ]
}
欄位
mandatoryAdText

object (AdTextAsset)

必要廣告文字。
headlines[]

object (AdTextAsset)

廣告標題文字素材資源清單。廣告放送時，系統會從這份清單中選取廣告標題。
descriptions[]

object (AdTextAsset)

說明文字素材資源清單。廣告放送時，就會從這份清單中選取。
images[]

object (AdImageAsset)

可隨廣告一起顯示的圖片素材資源清單。
youtubeVideos[]

object (AdVideoAsset)

可與廣告一併顯示的 YouTube 影片素材資源清單。
html5MediaBundles[]

object (AdMediaBundleAsset)

可能與廣告搭配使用的媒體組合素材資源清單。

AdMediaBundleAsset

廣告中使用的媒體組合素材資源。

JSON 表示法 
{
  "asset": string
}
欄位
asset

string

此媒體組合的素材資源資源名稱。

LegacyAppInstallAdInfo

僅限少數特定客戶使用的舊版應用程式安裝廣告。

JSON 表示法 
{
  "appStore": enum (LegacyAppInstallAdAppStore),
  "appId": string,
  "headline": string,
  "description1": string,
  "description2": string
}
欄位
appStore

enum (LegacyAppInstallAdAppStore)

行動應用程式已推出至應用程式商店。
appId

string

行動應用程式的 ID。
headline

string

廣告標題。
description1

string

廣告的第一行說明。
description2

string

廣告的第二行說明。

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 (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareLogoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadline": {
    object (AdTextAsset)
  },
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "formatSetting": enum (DisplayAdFormatSetting),
  "controlSpec": {
    object (ResponsiveDisplayAdControlSpec)
  },
  "businessName": string,
  "mainColor": string,
  "accentColor": string,
  "allowFlexibleColor": boolean,
  "callToActionText": string,
  "pricePrefix": string,
  "promoText": string
}
欄位
marketingImages[]

object (AdImageAsset)

要在廣告中使用的行銷圖片。有效的圖片類型為 GIF、JPEG 和 PNG。大小下限為 600x314，顯示比例必須為 1.91:1 (+-1%)。至少須提供一個 marketingImage。搭配 squareMarketingImages 使用，上限為 15 個。
squareMarketingImages[]

object (AdImageAsset)

要在廣告中使用的正方形行銷圖片。有效的圖片類型為 GIF、JPEG 和 PNG。大小下限為 300x300，顯示比例必須為 1:1 (+-1%)。至少要有一個正方形 marketingImage。搭配 marketingImages 使用，上限為 15 個。
logoImages[]

object (AdImageAsset)

要在廣告中使用的標誌圖片。有效的圖片類型為 GIF、JPEG 和 PNG。大小下限為 512x128，顯示比例必須為 4:1 (+-1%)。搭配 squareLogoImages 使用，上限為 5。
squareLogoImages[]

object (AdImageAsset)

要在廣告中使用的正方形標誌圖片。有效的圖片類型為 GIF、JPEG 和 PNG。大小下限為 128x128，顯示比例必須為 1:1 (+-1%)。搭配 logoImages 使用，上限為 5。
headlines[]

object (AdTextAsset)

廣告的短版標題。長度上限為 30 個半形字元。至少可以指定 1 個廣告標題 (最多 5 個)。
longHeadline

object (AdTextAsset)

必填的長廣告標題。長度上限為 90 個半形字元。
descriptions[]

object (AdTextAsset)

廣告的說明文字。長度上限為 90 個半形字元。至少可以指定 1 個廣告標題 (最多 5 個)。
youtubeVideos[]

object (AdVideoAsset)

廣告的選用 YouTube 影片。最多可以指定 5 部影片。
formatSetting

enum (DisplayAdFormatSetting)

指定廣告放送的格式。預設值為 ALL_FORMATS。
controlSpec

object (ResponsiveDisplayAdControlSpec)

各種廣告素材控制選項規格。
businessName

string

廣告主/品牌名稱。螢幕寬度上限為 25。
mainColor

string

廣告的主要顏色，以十六進位表示，例如 #ffffff 代表白色。如果設定了 mainColor 和 accentColor 其中之一，必須一併設定另一個。
accentColor

string

廣告的強調色以十六進位表示，例如 #ffffff 代表白色。如果設定了 mainColor 和 accentColor 其中之一，必須一併設定另一個。
allowFlexibleColor

boolean

廣告主同意允許彈性顏色。如果為 true，廣告可能會在必要時使用不同顏色。如果為 false，廣告會以指定顏色或中性色放送。預設值為 true。如未設定 mainColor 和 accentColor，則必須設為 true。
callToActionText

string

廣告的行動號召文字。螢幕寬度上限為 30。
pricePrefix

string

價格前的前置字串。例如「最低價格」。
promoText

string

用於回應式廣告動態格式的宣傳文字。例如「免費兩天內送達」。

ResponsiveDisplayAdControlSpec

回應式多媒體廣告的各種廣告素材控制項規格。

JSON 表示法 
{
  "enableAssetEnhancements": boolean,
  "enableAutogenVideo": boolean
}
欄位
enableAssetEnhancements

boolean

廣告主是否選擇使用素材資源強化功能。
enableAutogenVideo

boolean

廣告主是否選擇採用自動產生影片功能。

LocalAdInfo

區域廣告。

JSON 表示法 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "path1": string,
  "path2": string
}
欄位
headlines[]

object (AdTextAsset)

廣告標題文字素材資源清單。廣告放送時，系統會從這份清單中選取廣告標題。至少須指定 1 個，最多 5 個。
descriptions[]

object (AdTextAsset)

說明文字素材資源清單。廣告放送時，就會從這份清單中選取。至少須指定 1 則說明 (最多 5 則)。
callToActions[]

object (AdTextAsset)

行動號召文字素材資源清單。放送廣告時，系統會從這份清單中選取行動號召。至少必須指定 1 個和 5 個行動號召。
marketingImages[]

object (AdImageAsset)

可與廣告一併顯示的行銷圖片素材資源清單。圖片必須是 314x600 像素或 320x320 像素。至少須指定 1 項圖片素材資源，最多 20 項。
logoImages[]

object (AdImageAsset)

可與廣告一併顯示的標誌圖片素材資源清單。圖片的大小必須為 128x128 像素，且不得超過 120 KB。至少須指定 1 項圖片素材資源，最多 5 項。
videos[]

object (AdVideoAsset)

可與廣告一併顯示的 YouTube 影片素材資源清單。至少須指定 1 項影片素材資源，最多 20 項。
path1

string

第一部分可選文字，可以附加到廣告中的網址。
path2

string

第二部分可選文字，可附加到廣告中的網址。這個欄位只有在已設定 path1 時才能設定。

DisplayUploadAdInfo

通用的多媒體廣告。確切的廣告格式由 displayUploadProductType 欄位控制，該欄位會決定廣告需要納入的資料類型。

JSON 表示法 
{
  "displayUploadProductType": enum (DisplayUploadProductType),

  // Union field media_asset can be only one of the following:
  "mediaBundle": {
    object (AdMediaBundleAsset)
  }
  // End of list of possible types for union field media_asset.
}
欄位
displayUploadProductType

enum (DisplayUploadProductType)

此廣告的產品類型。詳情請參閱列舉的註解。
聯集欄位 media_asset。組成廣告的素材資源資料。media_asset 只能是下列其中一項：
mediaBundle

object (AdMediaBundleAsset)

要在廣告中使用的媒體組合素材資源。如要進一步瞭解 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 (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ]
}
欄位
headlines[]

object (AdTextAsset)

廣告標題文字素材資源清單。廣告放送時，系統會從這份清單中選取廣告標題。
descriptions[]

object (AdTextAsset)

說明文字素材資源清單。廣告放送時，就會從這份清單中選取。
images[]

object (AdImageAsset)

可隨廣告一起顯示的圖片素材資源清單。
videos[]

object (AdVideoAsset)

可隨廣告一起顯示的影片素材資源清單。

ShoppingComparisonListingAdInfo

購物比較資訊廣告。

JSON 表示法 
{
  "headline": string
}
欄位
headline

string

廣告的標題。這是必填欄位。允許的長度介於 25 到 45 個字元之間。

SmartCampaignAdInfo

智慧廣告活動的廣告。

JSON 表示法 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ]
}
欄位
headlines[]

object (AdTextAsset)

文字素材資源清單，每個素材資源都會對應廣告放送時的標題。這份清單包含至少 3 至 15 項文字素材資源。
descriptions[]

object (AdTextAsset)

文字素材資源清單，每個素材資源都會對應廣告放送時的說明。這份清單包含至少 2 到 4 個文字素材資源。

AppPreRegistrationAdInfo

應用程式預先註冊廣告可以連結到 Google Play 上的應用程式或遊戲資訊，可在 Google Play、YouTube (僅限串流內廣告) 以及多媒體廣告聯播網的其他應用程式和行動網站上放送。這麼做可引起使用者對應用程式或遊戲的興趣，讓應用程式或遊戲在上市前獲得一定的安裝基礎。

JSON 表示法 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ]
}
欄位
headlines[]

object (AdTextAsset)

廣告標題文字素材資源清單。廣告放送時，系統會從這份清單中選取廣告標題。
descriptions[]

object (AdTextAsset)

說明文字素材資源清單。廣告放送時，就會從這份清單中選取。
images[]

object (AdImageAsset)

圖片素材資源 ID 的清單，其圖片可能會與廣告一起顯示。
youtubeVideos[]

object (AdVideoAsset)

YouTube 影片資產 ID 清單，其中的影片可能會與廣告一併顯示。

DiscoveryMultiAssetAdInfo

探索多重素材資源廣告。

JSON 表示法 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "businessName": string,
  "callToActionText": string,
  "leadFormOnly": boolean
}
欄位
marketingImages[]

object (AdImageAsset)

要在廣告中使用的行銷圖片素材資源。有效的圖片類型為 GIF、JPEG 和 PNG。大小下限為 600x314，顯示比例必須為 1.91:1 (+-1%)。如果沒有 SquareMarketingImages，則為必要欄位。與 squareMarketingImages 和 portraitMarketingImages 合併使用，上限為 20。
squareMarketingImages[]

object (AdImageAsset)

要在廣告中使用的正方形行銷圖片素材資源。有效的圖片類型為 GIF、JPEG 和 PNG。大小下限為 300x300，顯示比例必須為 1:1 (+-1%)。如果缺少行銷圖片，則為必要欄位。與 marketingImages 和 portraitMarketingImages 合併使用，上限為 20。
portraitMarketingImages[]

object (AdImageAsset)

要在廣告中使用的直向行銷圖片素材資源。有效的圖片類型為 GIF、JPEG 和 PNG。大小下限為 480x600，顯示比例必須為 4:5 (+-1%)。與 marketingImages 和 squareMarketingImages 合併使用，上限為 20。
logoImages[]

object (AdImageAsset)

要在廣告中使用的標誌圖片素材資源。有效的圖片類型為 GIF、JPEG 和 PNG。大小下限為 128x128，顯示比例必須為 1:1 (+-1%)。至少可以指定 1 張標誌圖片，最多 5 張。
headlines[]

object (AdTextAsset)

廣告的廣告標題文字素材資源。螢幕寬度上限為 30。至少可以指定 1 個廣告標題 (最多 5 個)。
descriptions[]

object (AdTextAsset)

廣告的說明文字。螢幕寬度上限為 90。至少指定 1 則說明 (最多 5 則)。
businessName

string

廣告主/品牌名稱。螢幕寬度上限為 25。這是必填欄位。
callToActionText

string

行動號召文字。
leadFormOnly

boolean

布林值選項，指出廣告是否需要待開發客戶表單放送。

DiscoveryCarouselAdInfo

輪轉式探索廣告。

JSON 表示法 
{
  "businessName": string,
  "logoImage": {
    object (AdImageAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "callToActionText": string,
  "carouselCards": [
    {
      object (AdDiscoveryCarouselCardAsset)
    }
  ]
}
欄位
businessName

string

必要欄位。廣告主/品牌名稱。
logoImage

object (AdImageAsset)

必要欄位。要在廣告中使用的標誌圖片。大小下限為 128x128，顯示比例必須為 1:1 (+-1%)。
headline

object (AdTextAsset)

必要欄位。廣告標題。
description

object (AdTextAsset)

必要欄位。廣告的說明文字。
callToActionText

string

行動號召文字。
carouselCards[]

object (AdDiscoveryCarouselCardAsset)

必要欄位。伴隨廣告一同顯示的輪轉資訊卡。最少 2，最多 10。

AdDiscoveryCarouselCardAsset

廣告中使用的輪轉式探索廣告資訊卡素材資源。

JSON 表示法 
{
  "asset": string
}
欄位
asset

string

這張探索廣告輪轉介面資訊卡的資產資源名稱。

DiscoveryVideoResponsiveAdInfo

影片探索廣告。

JSON 表示法 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "callToActions": [
    {
      object (AdCallToActionAsset)
    }
  ]
}
欄位
headlines[]

object (AdTextAsset)

用於短廣告標題的文字素材資源清單。
longHeadlines[]

object (AdTextAsset)

用於長廣告標題的文字素材資源清單。
descriptions[]

object (AdTextAsset)

用於說明的文字素材資源清單。
videos[]

object (AdVideoAsset)

廣告使用的 YouTube 影片素材資源清單。
logoImages[]

object (AdImageAsset)

要在廣告中使用的標誌圖片。有效的圖片類型為 GIF、JPEG 和 PNG。大小下限為 128x128，顯示比例必須為 1:1 (+-1%)。
breadcrumb1

string

與顯示網址相符的廣告開頭文字。
breadcrumb2

string

廣告與顯示網址的第二部分文字。
businessName

object (AdTextAsset)

必要欄位。廣告主/品牌名稱。
callToActions[]

object (AdCallToActionAsset)

用於「行動號召」按鈕的 CallToActionAsset 類型的素材資源。

AdCallToActionAsset

廣告中使用的行動號召素材資源。

JSON 表示法 
{
  "asset": string
}
欄位
asset

string

此行動號召素材資源的素材資源資源名稱。

TravelAdInfo

這個類型沒有任何欄位。

旅遊廣告。

方法

get

 傳回請求的廣告完整詳情。

mutate

 更新廣告。