Asset

素材資源是可由多則廣告共用的廣告的一部分。素材資源可以是圖片 (ImageAsset)、影片 (YouTubeVideoAsset) 等。素材資源無法變更，也無法移除。如要停止放送素材資源，請從使用該素材資源的實體中移除該素材資源。

JSON 表示法 
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "source": enum (AssetSource),
  "policySummary": {
    object (AssetPolicySummary)
  },
  "fieldTypePolicySummaries": [
    {
      object (AssetFieldTypePolicySummary)
    }
  ],
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "mediaBundleAsset": {
    object (MediaBundleAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "leadFormAsset": {
    object (LeadFormAsset)
  },
  "bookOnGoogleAsset": {
    object (BookOnGoogleAsset)
  },
  "promotionAsset": {
    object (PromotionAsset)
  },
  "calloutAsset": {
    object (CalloutAsset)
  },
  "structuredSnippetAsset": {
    object (StructuredSnippetAsset)
  },
  "sitelinkAsset": {
    object (SitelinkAsset)
  },
  "pageFeedAsset": {
    object (PageFeedAsset)
  },
  "dynamicEducationAsset": {
    object (DynamicEducationAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "hotelCalloutAsset": {
    object (HotelCalloutAsset)
  },
  "callAsset": {
    object (CallAsset)
  },
  "priceAsset": {
    object (PriceAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "dynamicRealEstateAsset": {
    object (DynamicRealEstateAsset)
  },
  "dynamicCustomAsset": {
    object (DynamicCustomAsset)
  },
  "dynamicHotelsAndRentalsAsset": {
    object (DynamicHotelsAndRentalsAsset)
  },
  "dynamicFlightsAsset": {
    object (DynamicFlightsAsset)
  },
  "discoveryCarouselCardAsset": {
    object (DiscoveryCarouselCardAsset)
  },
  "dynamicTravelAsset": {
    object (DynamicTravelAsset)
  },
  "dynamicLocalAsset": {
    object (DynamicLocalAsset)
  },
  "dynamicJobsAsset": {
    object (DynamicJobsAsset)
  },
  "locationAsset": {
    object (LocationAsset)
  },
  "hotelPropertyAsset": {
    object (HotelPropertyAsset)
  }
  // End of list of possible types for union field asset_data.
}
欄位
resourceName

string

不可變動。資產的資源名稱。資產資源名稱的格式如下：

customers/{customerId}/assets/{asset_id}
type

enum (AssetType)

僅供輸出。資產的類型。
finalUrls[]

string

在所有跨網域重新導向後方的可能最終到達網址清單。
finalMobileUrls[]

string

在所有跨網域重新導向後方的可能最終行動版網址清單。
urlCustomParameters[]

object (CustomParameter)

一份對應清單，用於替換 trackUrlTemplate、finalUrls 和/或 finalMobileUrls 中附加網址自訂參數代碼的對應。
source

enum (AssetSource)

僅供輸出。資產來源。
policySummary

object (AssetPolicySummary)

僅供輸出。資產的政策資訊。
fieldTypePolicySummaries[]

object (AssetFieldTypePolicySummary)

僅供輸出。各 FieldType 的資產政策資訊。
id

string (int64 format)

僅供輸出。資產 ID。
name

string

素材資源名稱 (選填)。
trackingUrlTemplate

string

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

string

網址範本：將參數附加至採用並行追蹤功能的到達網頁網址。
聯集欄位 asset_data。資產的特定類型。asset_data 只能是下列其中一項：
youtubeVideoAsset

object (YoutubeVideoAsset)

不可變動。YouTube 影片素材資源。
mediaBundleAsset

object (MediaBundleAsset)

不可變動。媒體組合素材資源。
imageAsset

object (ImageAsset)

僅供輸出。圖片素材資源。
textAsset

object (TextAsset)

不可變動。文字素材資源。
leadFormAsset

object (LeadFormAsset)

待開發客戶表單素材資源。
bookOnGoogleAsset

object (BookOnGoogleAsset)

Google 素材資源上的書籍。
promotionAsset

object (PromotionAsset)

宣傳素材資源。
calloutAsset

object (CalloutAsset)

摘要素材資源。
structuredSnippetAsset

object (StructuredSnippetAsset)

網站簡介素材資源。
pageFeedAsset

object (PageFeedAsset)

網頁動態饋給素材資源。
dynamicEducationAsset

object (DynamicEducationAsset)

動態教育素材資源。
mobileAppAsset

object (MobileAppAsset)

行動應用程式素材資源。
hotelCalloutAsset

object (HotelCalloutAsset)

飯店摘要素材資源。
callAsset

object (CallAsset)

電話素材資源。
priceAsset

object (PriceAsset)

價格素材資源。
callToActionAsset

object (CallToActionAsset)

不可變動。行動號召素材資源。
dynamicRealEstateAsset

object (DynamicRealEstateAsset)

動態房地產素材資源。
dynamicCustomAsset

object (DynamicCustomAsset)

動態自訂素材資源。
dynamicHotelsAndRentalsAsset

object (DynamicHotelsAndRentalsAsset)

動態飯店和度假民宿素材資源。
dynamicFlightsAsset

object (DynamicFlightsAsset)

動態航班素材資源。
dynamicTravelAsset

object (DynamicTravelAsset)

動態的旅遊素材資源。
dynamicLocalAsset

object (DynamicLocalAsset)

動態的本機素材資源。
dynamicJobsAsset

object (DynamicJobsAsset)

動態工作資產。
locationAsset

object (LocationAsset)

僅供輸出。地點素材資源。
hotelPropertyAsset

object (HotelPropertyAsset)

不可變動。飯店房源素材資源。

AssetType

列舉說明可能的資產類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
YOUTUBE_VIDEO YouTube 影片素材資源。
MEDIA_BUNDLE 媒體組合素材資源。
IMAGE 圖片素材資源。
TEXT 文字素材資源。
LEAD_FORM 待開發客戶表單素材資源。
BOOK_ON_GOOGLE 透過 Google 預訂素材資源。
PROMOTION 宣傳素材資源。
CALLOUT 摘要素材資源。
STRUCTURED_SNIPPET 網站簡介素材資源。
PAGE_FEED 網頁動態饋給素材資源。
DYNAMIC_EDUCATION 動態教育素材資源。
MOBILE_APP 行動應用程式素材資源。
HOTEL_CALLOUT 飯店摘要素材資源。
CALL 電話素材資源。
PRICE 價格素材資源。
CALL_TO_ACTION 行動號召素材資源。
DYNAMIC_REAL_ESTATE 動態房地產素材資源。
DYNAMIC_CUSTOM 動態自訂素材資源。
DYNAMIC_HOTELS_AND_RENTALS 動態飯店和度假民宿素材資源。
DYNAMIC_FLIGHTS 動態航班素材資源。
DYNAMIC_TRAVEL 動態旅遊素材資源。
DYNAMIC_LOCAL 動態地區素材資源。
DYNAMIC_JOBS 動態工作素材資源。
LOCATION 地點素材資源。
HOTEL_PROPERTY 飯店房源素材資源。

AssetPolicySummary

包含資產的政策資訊。

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

object (PolicyTopicEntry)

僅供輸出。這項資產的政策發現項目清單。
reviewStatus

enum (PolicyReviewStatus)

僅供輸出。此素材資源處於審查階段的哪個階段。
approvalStatus

enum (PolicyApprovalStatus)

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

AssetFieldTypePolicySummary

包含 AssetFieldType 結構定義下資產的政策資訊。

JSON 表示法 
{
  "assetFieldType": enum (AssetFieldType),
  "assetSource": enum (AssetSource),
  "policySummaryInfo": {
    object (AssetPolicySummary)
  }
}
欄位
assetFieldType

enum (AssetFieldType)

僅供輸出。這項資產的 FieldType。
assetSource

enum (AssetSource)

僅供輸出。這項素材資源的來源。
policySummaryInfo

object (AssetPolicySummary)

僅供輸出。政策摘要。

YoutubeVideoAsset

YouTube 資產。

JSON 表示法 
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
欄位
youtubeVideoTitle

string

YouTube 影片標題。
youtubeVideoId

string

YouTube 影片 ID。這是 YouTube 影片網址中使用的 11 個字元字串值。

MediaBundleAsset

MediaBundle 素材資源。

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

string (bytes format)

媒體組合 (ZIP 檔案) 素材資源資料。所上傳 ZIP 檔案的格式，取決於要使用該檔案的廣告欄位。如要進一步瞭解格式，請參閱您打算使用 MediaBundleAsset 的廣告欄位說明文件。這個欄位只會發生變更。

Base64 編碼的字串。

ImageAsset

圖片素材資源。

JSON 表示法 
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "data": string,
  "fileSize": string
}
欄位
mimeType

enum (MimeType)

圖片素材資源的 MIME 類型。
fullSize

object (ImageDimension)

這張圖片原始大小的中繼資料。
data

string (bytes format)

圖片的原始位元組資料。這個欄位只會發生變更。

Base64 編碼的字串。
fileSize

string (int64 format)

圖片素材資源的檔案大小，以位元組為單位。

ImageDimension

特定大小的圖片中繼資料 (不論原始大小或大小經過調整)。

JSON 表示法 
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
欄位
heightPixels

string (int64 format)

圖片的高度。
widthPixels

string (int64 format)

圖片的寬度。
url

string

傳回網址包含此高度和寬度的圖片。

TextAsset

文字素材資源。

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

string

文字素材資源的文字內容。

LeadFormAsset

待開發客戶表單素材資源。

JSON 表示法 
{
  "businessName": string,
  "callToActionType": enum (LeadFormCallToActionType),
  "callToActionDescription": string,
  "headline": string,
  "description": string,
  "privacyPolicyUrl": string,
  "fields": [
    {
      object (LeadFormField)
    }
  ],
  "customQuestionFields": [
    {
      object (LeadFormCustomQuestionField)
    }
  ],
  "deliveryMethods": [
    {
      object (LeadFormDeliveryMethod)
    }
  ],
  "postSubmitCallToActionType": enum (LeadFormPostSubmitCallToActionType),
  "desiredIntent": enum (LeadFormDesiredIntent),
  "postSubmitHeadline": string,
  "postSubmitDescription": string,
  "backgroundImageAsset": string,
  "customDisclosure": string
}
欄位
businessName

string

必要欄位。所宣傳商家名稱。
callToActionType

enum (LeadFormCallToActionType)

必要欄位。預先定義的顯示文字，鼓勵使用者展開表單。
callToActionDescription

string

必要欄位。文字針對使用者展開表單後預期得到的期望，提供明確的價值主張。
headline

string

必要欄位。展開表單的標題，說明表單要求或推薦的內容。
description

string

必要欄位。展開表單的詳細說明，說明表單要求或推薦的內容。
privacyPolicyUrl

string

必要欄位。這個連結所導向的網頁說明瞭廣告客戶/商家處理資料收集方式的相關政策。
fields[]

object (LeadFormField)

輸入欄位的已排序清單。這個欄位可藉由重新排序問題來更新，但無法新增或移除問題。
customQuestionFields[]

object (LeadFormCustomQuestionField)

自訂問題欄位的已排序清單。每份表單最多僅能對應 5 個符合資格的問題。
deliveryMethods[]

object (LeadFormDeliveryMethod)

設定將收集到的待開發客戶資料傳送給廣告客戶的方法。只能設定一種 WebhookDelivery 類型的方法。
postSubmitCallToActionType

enum (LeadFormPostSubmitCallToActionType)

預先定義的顯示文字，鼓勵使用者在提交表單後採取行動。
desiredIntent

enum (LeadFormDesiredIntent)

選擇待開發客戶表單的意圖，例如增加人數或符合資格。
postSubmitHeadline

string

提交表單後顯示的文字標題，說明廣告客戶如何追蹤使用者。
postSubmitDescription

string

提交表單後顯示的詳細說明，說明廣告客戶如何追蹤使用者。
backgroundImageAsset

string

背景圖片的素材資源資源名稱。圖片尺寸必須正好為 1200x628。
customDisclosure

string

在待開發客戶表單中，自訂揭露聲明會與 Google 免責事項一併顯示。僅限允許的客戶存取。

LeadFormCallToActionType

列舉說明待開發客戶表單中的行動號召詞組類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
LEARN_MORE 瞭解詳情。
GET_QUOTE 取得報價。
APPLY_NOW 立即申請。
SIGN_UP 註冊。
CONTACT_US 歡迎與我們聯絡
SUBSCRIBE 。
DOWNLOAD 。
BOOK_NOW 立即預訂。
GET_OFFER 取得優惠。
REGISTER 註冊。
GET_INFO 取得資訊。
REQUEST_DEMO 索取示範資源。
JOIN_NOW 立即加入。
GET_STARTED 開始使用

LeadFormField

表單中的一個輸入欄位例項。

JSON 表示法 
{
  "inputType": enum (LeadFormFieldUserInputType),

  // Union field answers can be only one of the following:
  "singleChoiceAnswers": {
    object (LeadFormSingleChoiceAnswers)
  },
  "hasLocationAnswer": boolean
  // End of list of possible types for union field answers.
}
欄位
inputType

enum (LeadFormFieldUserInputType)

說明輸入類型，這可以是預先定義類型，例如「全名」或預先篩選的問題，例如「您擁有哪一種車輛？」。
聯集欄位 answers。定義這份表單欄位接受的答案設定。如果沒有設定任何答案，則此為自由文字答案。answers 只能是下列其中一項：
singleChoiceAnswers

object (LeadFormSingleChoiceAnswers)

單選題的答案設定。僅針對預先審查的問題欄位設定。最少需要提供 2 個答案，最多 12 個。
hasLocationAnswer

boolean

位置問題的答案設定。若為 true，待開發客戶表單會顯示廣告活動/帳戶層級的位置資料 (州/省、城市、商家名稱等)。自 V13.1 版本起，廣告客戶在廣告活動/帳戶層級設定地點素材資源後，只能針對「您偏好的經銷商為何？」問題設定 hasLocationAnswer。

LeadFormSingleChoiceAnswers

定義單一選擇題的可能答案，通常以單選下拉式清單的形式呈現。

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

string

單一問題欄位的選項清單。項目的順序會決定 UI 的順序。最少需要提供 2 個答案，最多 12 個。

LeadFormCustomQuestionField

表單中的一個自訂問題輸入欄位例項。

JSON 表示法 
{
  "customQuestionText": string,

  // Union field answers can be only one of the following:
  "singleChoiceAnswers": {
    object (LeadFormSingleChoiceAnswers)
  },
  "hasLocationAnswer": boolean
  // End of list of possible types for union field answers.
}
欄位
customQuestionText

string

確切的自訂問題欄位文字 (例如「你擁有哪種類型的車輛？」)。
聯集欄位 answers。定義這份表單欄位接受的答案設定。如果沒有設定任何答案，則此為自由文字答案。answers 只能是下列其中一項：
singleChoiceAnswers

object (LeadFormSingleChoiceAnswers)

單選題的答案設定。最少 2 個答案，最多 12 個。
hasLocationAnswer

boolean

位置問題的答案設定。若為 true，待開發客戶表單會顯示廣告活動/帳戶層級的位置資料 (州/省、城市、商家名稱等)。自 V13.1 版本起，廣告客戶在廣告活動/帳戶層級設定地點素材資源後，只能針對「您偏好的經銷商為何？」問題設定 hasLocationAnswer。

LeadFormDeliveryMethod

設定待開發客戶觸及廣告客戶的方式。

JSON 表示法 
{

  // Union field delivery_details can be only one of the following:
  "webhook": {
    object (WebhookDelivery)
  }
  // End of list of possible types for union field delivery_details.
}
欄位
聯集欄位 delivery_details。各種提交子類型。delivery_details 只能是下列其中一項：
webhook

object (WebhookDelivery)

Webhook 提供方式。

WebhookDelivery

Google 會向廣告客戶發出 HTTP 呼叫，向廣告客戶通知他們指定的端點，這些請求中包含 JSON 比對的結構定義 (Google 會在表單廣告說明文件中發布這個結構定義)。

JSON 表示法 
{
  "advertiserWebhookUrl": string,
  "googleSecret": string,
  "payloadSchemaVersion": string
}
欄位
advertiserWebhookUrl

string

廣告主指定來傳送待開發客戶的 Webhook 網址。
googleSecret

string

廣告客戶在 Webhook 酬載中設定的防偽密鑰。
payloadSchemaVersion

string (int64 format)

這個推送執行個體使用的結構定義版本。

LeadFormPostSubmitCallToActionType

以列舉方式說明待開發客戶表單的提交後行動號召詞組類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
VISIT_SITE 前往網站。
DOWNLOAD 。
LEARN_MORE 瞭解詳情。
SHOP_NOW 立即購買。

LeadFormDesiredIntent

列舉說明所選擇產生待開發客戶的意願等級。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
LOW_INTENT 以較低的品質觸及更多待開發客戶。
HIGH_INTENT 發掘更有價值的待開發客戶。

BookOnGoogleAsset

這個類型沒有任何欄位。

「透過 Google 訂房」素材資源。用於將使用者重新導向，透過 Google 預訂。「透過 Google 訂房」會變更重新導向網址，以便直接透過 Google 預訂。

PromotionAsset

宣傳素材資源。

JSON 表示法 
{
  "promotionTarget": string,
  "discountModifier": enum (PromotionExtensionDiscountModifier),
  "redemptionStartDate": string,
  "redemptionEndDate": string,
  "occasion": enum (PromotionExtensionOccasion),
  "languageCode": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],

  // Union field discount_type can be only one of the following:
  "percentOff": string,
  "moneyAmountOff": {
    object (Money)
  }
  // End of list of possible types for union field discount_type.

  // Union field promotion_trigger can be only one of the following:
  "promotionCode": string,
  "ordersOverAmount": {
    object (Money)
  }
  // End of list of possible types for union field promotion_trigger.
}
欄位
promotionTarget

string

必要欄位。促銷活動指定目標的任意形式說明。
discountModifier

enum (PromotionExtensionDiscountModifier)

用來評估折扣的修飾符。
redemptionStartDate

string

符合促銷活動資格的開始日期，格式為 yyyy-MM-dd。
redemptionEndDate

string

可兌換促銷代碼的最後一天，格式為 yyyy-MM-dd。
occasion

enum (PromotionExtensionOccasion)

促銷活動的指定時機。如果設定了場合，兌換期必須落在與該優惠相關聯的日期範圍內。
languageCode

string

促銷活動的語言。以 BCP 47 語言標記表示。
startDate

string

此素材資源有效且可以開始放送的開始日期，格式為 yyyy-MM-dd。
endDate

string

這項素材資源有效且仍在放送中的最後日期，格式為 yyyy-MM-dd。
adScheduleTargets[]

object (AdScheduleInfo)

非重疊時段清單，用於指定素材資源可能放送的所有時間間隔。每天最多只能有 6 個時間表，共 42 個。
聯集欄位 discount_type。折扣類型可以是折扣百分比或折扣金額。discount_type 只能採用下列其中一種設定：
percentOff

string (int64 format)

促銷活動折扣百分比。1,000,000 = 100%。必須提供此值或 payAmountOff。
moneyAmountOff

object (Money)

促銷活動折扣金額。必須設定這個值或 %Off。
聯集欄位 promotion_trigger。促銷活動觸發條件。取決於促銷代碼或符合資格的訂單金額。promotion_trigger 只能是下列其中一項：
promotionCode

string

使用者能使用這組代碼才能符合促銷優惠資格。
ordersOverAmount

object (Money)

使用者享有促銷優惠所需的總訂單金額。

CalloutAsset

摘要素材資源。

JSON 表示法 
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ]
}
欄位
calloutText

string

必要欄位。摘要文字。此字串長度必須介於 1 到 25 (含) 個字元之間。
startDate

string

此素材資源有效且可以開始放送的開始日期，格式為 yyyy-MM-dd。
endDate

string

這項素材資源有效且仍在放送中的最後日期，格式為 yyyy-MM-dd。
adScheduleTargets[]

object (AdScheduleInfo)

非重疊時段清單，用於指定素材資源可能放送的所有時間間隔。每天最多只能有 6 個時間表，共 42 個。

StructuredSnippetAsset

網站簡介素材資源。

JSON 表示法 
{
  "header": string,
  "values": [
    string
  ]
}
欄位
header

string

必要欄位。程式碼片段的標題。這個字串應為 https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers 的其中一個預先定義值
values[]

string

必要欄位。程式碼片段中的值。此集合的大小必須介於 3 到 10 (含) 之間。每個值的長度必須介於 1 到 25 個字元 (含首尾)。

SitelinkAsset

網站連結素材資源。

JSON 表示法 
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ]
}
欄位
linkText

string

必要欄位。網站連結的網址顯示文字。此字串長度必須介於 1 到 25 (含) 個字元之間。
description1

string

網站連結說明的第一行。如有設定，必須一併設定長度介於 1 到 35 之間 (含首尾)，並且包含 description2。
description2

string

網站連結說明的第二行。如有設定，必須一併設定長度介於 1 到 35 之間 (含首尾)，並且包含 description1。
startDate

string

此素材資源有效且可以開始放送的開始日期，格式為 yyyy-MM-dd。
endDate

string

這項素材資源有效且仍在放送中的最後日期，格式為 yyyy-MM-dd。
adScheduleTargets[]

object (AdScheduleInfo)

非重疊時段清單，用於指定素材資源可能放送的所有時間間隔。每天最多只能有 6 個時間表，共 42 個。

PageFeedAsset

網頁動態饋給素材資源。

JSON 表示法 
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
欄位
pageUrl

string

必要欄位。廣告客戶想指定的網頁。
labels[]

string

用來將網頁網址分組的標籤。

DynamicEducationAsset

動態教育素材資源。

JSON 表示法 
{
  "programId": string,
  "locationId": string,
  "programName": string,
  "subject": string,
  "programDescription": string,
  "schoolName": string,
  "address": string,
  "contextualKeywords": [
    string
  ],
  "androidAppLink": string,
  "similarProgramIds": [
    string
  ],
  "iosAppLink": string,
  "iosAppStoreId": string,
  "thumbnailImageUrl": string,
  "imageUrl": string
}
欄位
programId

string

必要欄位。計劃編號可以是任何英文字母和數字，而且不得重複且必須與再行銷代碼的值相符。這是必填欄位。
locationId

string

地區 ID，可以是任何一串字母和數字，而且不得重複。
programName

string

必要欄位。課程名稱，例如護理課程名稱。這是必填欄位。
subject

string

學科，例如「健康」。
programDescription

string

計畫說明，例如護理認證。
schoolName

string

學校名稱，例如 Mountain View School of Nursing。
address

string

可使用以下其中一種格式指定的學校地址。(1) 城市、州/省、代碼、國家/地區，例如 Mountain View, CA, USA。(2) 完整地址，例如臺北市信義區信義路五段 7 號。(3) 以 DDD 格式顯示的經緯度，例如 41.40338, 2.17403
contextualKeywords[]

string

內容比對關鍵字，例如護理認證、健康和山景城。
similarProgramIds[]

string

類似課程 ID。
iosAppStoreId

string (int64 format)

iOS App Store ID。系統會先根據這個屬性檢查使用者裝置是否已經安裝了應用程式，再透過深層連結將使用者帶往到達網頁。如果設定了這個欄位，就必須一併顯示 iosAppLink 欄位。
thumbnailImageUrl

string

縮圖網址，例如 http://www.example.com/thumbnail.png。縮圖圖片將不會上傳為圖片素材資源。
imageUrl

string

圖片網址，例如 http://www.example.com/image.png。系統不會上傳這張圖片做為圖片素材資源。

MobileAppAsset

代表行動應用程式的素材資源。

JSON 表示法 
{
  "appId": string,
  "appStore": enum (MobileAppVendor),
  "linkText": string,
  "startDate": string,
  "endDate": string
}
欄位
appId

string

必要欄位。用以識別行動應用程式的字串。只能包含平台原生 ID，例如「com.android.ebay」(Android 為「com.android.ebay」) 或 iOS 的「12345689」(iOS)。
appStore

enum (MobileAppVendor)

必要欄位。發行這個特定應用程式的應用程式商店。
linkText

string

必要欄位。連結顯示在廣告中時所顯示的文字。此字串長度必須介於 1 到 25 (含) 個字元之間。
startDate

string

此素材資源有效且可以開始放送的開始日期，格式為 yyyy-MM-dd。
endDate

string

這項素材資源有效且仍在放送中的最後日期，格式為 yyyy-MM-dd。

HotelCalloutAsset

代表飯店摘要的素材資源。

JSON 表示法 
{
  "text": string,
  "languageCode": string
}
欄位
text

string

必要欄位。飯店摘要素材資源的文字。此字串長度必須介於 1 到 25 (含) 個字元之間。
languageCode

string

必要欄位。飯店摘要的語言。以 BCP 47 語言標記表示。

CallAsset

電話素材資源。

JSON 表示法 
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ]
}
欄位
countryCode

string

必要欄位。電話號碼的雙字母國家/地區代碼。例如：「US」、「us」。
phoneNumber

string

必要欄位。廣告客戶的原始電話號碼。範例：「1234567890」、「(123)456-7890」
callConversionReportingState

enum (CallConversionReportingState)

指出這項 CallAsset 是否應使用自己的來電轉換設定、採用帳戶層級設定，還是停用來電轉換。
callConversionAction

string

要將來電轉換歸因於哪個轉換動作。如果未設定，系統會採用預設的轉換動作。只有在 callConversionReportingState 設為 USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION 時，這個欄位才會生效。
adScheduleTargets[]

object (AdScheduleInfo)

非重疊時段清單，用於指定素材資源可能放送的所有時間間隔。每天最多只能有 6 個時間表，共 42 個。

PriceAsset

代表價格優惠清單的素材資源。

JSON 表示法 
{
  "type": enum (PriceExtensionType),
  "priceQualifier": enum (PriceExtensionPriceQualifier),
  "languageCode": string,
  "priceOfferings": [
    {
      object (PriceOffering)
    }
  ]
}
欄位
type

enum (PriceExtensionType)

必要欄位。價格素材資源的類型。
priceQualifier

enum (PriceExtensionPriceQualifier)

價格素材資源的價格條件。
languageCode

string

必要欄位。價格素材資源的語言。以 BCP 47 語言標記表示。
priceOfferings[]

object (PriceOffering)

價格素材資源的價格。此集合的大小必須介於 3 到 8 之間 (含 3 和 8)。

PriceOffering

PriceAsset 中的單一價格產品。

JSON 表示法 
{
  "header": string,
  "description": string,
  "price": {
    object (Money)
  },
  "unit": enum (PriceExtensionPriceUnit),
  "finalUrl": string,
  "finalMobileUrl": string
}
欄位
header

string

必要欄位。價格項目的標題。此字串長度必須介於 1 到 25 (含) 個字元之間。
description

string

必要欄位。價格的說明。此字串長度必須介於 1 到 25 (含) 個字元之間。
price

object (Money)

必要欄位。提供的價格值。
unit

enum (PriceExtensionPriceUnit)

價格單位的價格單位。
finalUrl

string

必要欄位。在所有跨網域重新導向後方的最終到達網址。
finalMobileUrl

string

在所有跨網域重新導向後方的最終行動版網址。

CallToActionAsset

行動號召素材資源。

JSON 表示法 
{
  "callToAction": enum (CallToActionType)
}
欄位
callToAction

enum (CallToActionType)

行動號召。

DynamicRealEstateAsset

動態房地產素材資源。

JSON 表示法 
{
  "listingId": string,
  "listingName": string,
  "cityName": string,
  "description": string,
  "address": string,
  "price": string,
  "imageUrl": string,
  "propertyType": string,
  "listingType": string,
  "contextualKeywords": [
    string
  ],
  "formattedPrice": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "similarListingIds": [
    string
  ]
}
欄位
listingId

string

必要欄位。產品資訊 ID 可以是任何一串字母和數字，而且不得重複且必須與再行銷代碼的值相符。這是必填欄位。
listingName

string

必要欄位。房源名稱，例如 Boulevard Bungalow。這是必填欄位。
cityName

string

城市名稱，例如美國加州山景城。
description

string

說明，例如 3 張床、2 座浴池、1568 平方英尺
address

string

可使用以下格式指定的地址。(1) 城市、州/省、代碼、國家/地區，例如 Mountain View, CA, USA。(2) 完整地址，例如臺北市信義區信義路五段 7 號。(3) 以 DDD 格式顯示的經緯度，例如 41.40338, 2.17403
price

string

價格可以是數字，後面加上字母貨幣代碼，採 ISO 4217 標準。請使用「.」做為小數點符號，例如：200,000.00 美元。
imageUrl

string

圖片網址，例如 http://www.example.com/image.png。系統不會上傳這張圖片做為圖片素材資源。
propertyType

string

物業類型，例如「房屋」。
listingType

string

房源類型 (例如：特價)。
contextualKeywords[]

string

內容比對關鍵字，例如待售和待售房屋。
formattedPrice

string

格式化價格，可以是任何字元。如有設定，則這項屬性會取代「price」，例如 $200,000.00 美元起。
iosAppStoreId

string (int64 format)

iOS App Store ID。系統會先根據這個屬性檢查使用者裝置是否已經安裝了應用程式，再透過深層連結將使用者帶往到達網頁。如果設定了這個欄位，就必須一併顯示 iosAppLink 欄位。
similarListingIds[]

string

類似房源 ID。

DynamicCustomAsset

動態自訂素材資源。

JSON 表示法 
{
  "id": string,
  "id2": string,
  "itemTitle": string,
  "itemSubtitle": string,
  "itemDescription": string,
  "itemAddress": string,
  "itemCategory": string,
  "price": string,
  "salePrice": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "imageUrl": string,
  "contextualKeywords": [
    string
  ],
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "similarIds": [
    string
  ]
}
欄位
id

string

必要欄位。ID 可以是任何一串英文字母和數字，而且不得重複，且必須與再行銷代碼的值相符 (例如 sedan)。這是必填欄位。
id2

string

ID2 可以是任何一串字母和數字，例如紅色。ID 序列 (ID + ID2) 不得重複。
itemTitle

string

必要欄位。商品名稱，例如中等尺寸的轎車。這是必填欄位。
itemSubtitle

string

商品子標題，例如山景城經銷商。
itemDescription

string

商品說明，例如：最暢銷的中型車款。
itemAddress

string

項目地址，可以使用下列其中一種格式指定。(1) 城市、州/省、代碼、國家/地區，例如 Mountain View, CA, USA。(2) 完整地址，例如臺北市信義區信義路五段 7 號。(3) 以 DDD 格式顯示的經緯度，例如 41.40338, 2.17403
itemCategory

string

項目類別，例如「轎車」。
price

string

價格可以是數字，後面加上字母貨幣代碼，採 ISO 4217 標準。請使用「.」做為小數，例如 $20,000.00 美元。
salePrice

string

特價，可以是數字，後面加上字母貨幣代碼，採 ISO 4217 標準。請使用「.」做為小數，例如 $15,000.00 美元。必須小於「價格」欄位。
formattedPrice

string

格式化價格，可以是任何字元。設定此屬性後，系統就會使用這項屬性取代「price」，例如「$20,000.00 美元起」。
formattedSalePrice

string

格式化特價，可以是任何字元。如果設定這個屬性，這項屬性就會取代「sale price [特價]」，例如：特價 $15,000.00 美元。
imageUrl

string

圖片網址，例如 http://www.example.com/image.png。系統不會上傳這張圖片做為圖片素材資源。
contextualKeywords[]

string

內容比對關鍵字，例如「轎車」、「4 門房車」。
iosAppStoreId

string (int64 format)

iOS App Store ID。系統會先根據這個屬性檢查使用者裝置是否已經安裝了應用程式，再透過深層連結將使用者帶往到達網頁。如果設定了這個欄位，就必須一併顯示 iosAppLink 欄位。
similarIds[]

string

類似 ID。

DynamicHotelsAndRentalsAsset

動態飯店和度假民宿素材資源。

JSON 表示法 
{
  "propertyId": string,
  "propertyName": string,
  "imageUrl": string,
  "destinationName": string,
  "description": string,
  "price": string,
  "salePrice": string,
  "starRating": string,
  "category": string,
  "contextualKeywords": [
    string
  ],
  "address": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "similarPropertyIds": [
    string
  ]
}
欄位
propertyId

string

必要欄位。資源 ID 可以是任何一串字母和數字，而且不得重複且必須與再行銷代碼的值相符。這是必填欄位。
propertyName

string

必要欄位。房源名稱，例如 Mountain View Hotel. 這是必填欄位。
imageUrl

string

圖片網址，例如 http://www.example.com/image.png。系統不會上傳這張圖片做為圖片素材資源。
destinationName

string

目的地名稱，例如臺北市信義區。
description

string

說明，例如「靠近 SJC 機場」。
price

string

價格可以是數字，後面加上字母貨幣代碼，採 ISO 4217 標準。請使用「.」做為小數點，例如「100.00 美元」。
salePrice

string

ISO 4217 標準。請使用「.」做為小數，例如「80.00 USD」。必須小於「價格」欄位。
starRating

string (int64 format)

星級評等。必須是介於 1 至 5 (含) 之間的數字。
category

string

類別 (例如「飯店套房」)。
contextualKeywords[]

string

內容比對關鍵字，例如山景城「飯店」、南灣飯店。
address

string

可使用以下格式指定的地址。(1) 城市、州/省、代碼、國家/地區，例如 Mountain View, CA, USA。(2) 完整地址，例如臺北市信義區信義路五段 7 號。(3) 以 DDD 格式顯示的經緯度，例如 41.40338, 2.17403
iosAppStoreId

string (int64 format)

iOS App Store ID。系統會先根據這個屬性檢查使用者裝置是否已經安裝了應用程式，再透過深層連結將使用者帶往到達網頁。如果設定了這個欄位，就必須一併顯示 iosAppLink 欄位。
formattedPrice

string

格式化價格，可以是任何字元。設定後，系統就會使用這項屬性取代「price」，例如 $100.00 美元起。
formattedSalePrice

string

格式化特價，可以是任何字元。如果設定這個屬性，這項屬性就會取代「sale price [特價]」，例如「特價」為 $80.00 美元。
similarPropertyIds[]

string

類似物業 ID。

DynamicFlightsAsset

動態航班素材資源。

JSON 表示法 
{
  "destinationId": string,
  "originId": string,
  "flightDescription": string,
  "imageUrl": string,
  "destinationName": string,
  "originName": string,
  "flightPrice": string,
  "flightSalePrice": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "similarDestinationIds": [
    string
  ],
  "customMapping": string
}
欄位
destinationId

string

必要欄位。目的地編號可以是任何一串字母和數字，而且不得重複且必須與再行銷代碼的值相符。這是必填欄位。
originId

string

起點 ID，可以是任何字母和數字的序列。ID 序列 (目的地 ID + 起點 ID) 不得重複。
flightDescription

string

必要欄位。航班說明，例如預訂票券。這是必填欄位。
imageUrl

string

圖片網址，例如 http://www.example.com/image.png。系統不會上傳這張圖片做為圖片素材資源。
destinationName

string

目的地名稱，例如巴黎。
originName

string

出發地名稱，例如倫敦。
flightPrice

string

航班價格，前面可加上字母貨幣代碼，採 ISO 4217 標準。請使用「.」做為小數點，例如「100.00 美元」。
flightSalePrice

string

航班特價，數字後面可加上字母貨幣代碼，採 ISO 4217 標準。請使用「.」做為小數，例如「80.00 USD」。必須小於「flightPrice」欄位。
formattedPrice

string

格式化價格，可以是任何字元。設定後，系統就會使用這項屬性取代「price」，例如 $100.00 美元起。
formattedSalePrice

string

格式化特價，可以是任何字元。如果設定這個屬性，這項屬性就會取代「sale price [特價]」，例如「特價」為 $80.00 美元。
iosAppStoreId

string (int64 format)

iOS App Store ID。系統會先根據這個屬性檢查使用者裝置是否已經安裝了應用程式，再透過深層連結將使用者帶往到達網頁。如果設定了這個欄位，就必須一併顯示 iosAppLink 欄位。
similarDestinationIds[]

string

類似目的地 ID，例如 PAR、LON。
customMapping

string

這個自訂欄位可由多個鍵與值對應，並以「: 、、... 、 | : , ... , | ... | : , ... ," 為例，連接方式為 320, 73W | 班機：

DiscoveryCarouselCardAsset

輪轉式探索資訊卡素材資源。

JSON 表示法 
{
  "marketingImageAsset": string,
  "squareMarketingImageAsset": string,
  "portraitMarketingImageAsset": string,
  "headline": string,
  "callToActionText": string
}
欄位
marketingImageAsset

string

相關 1.91:1 行銷圖片的資產資源名稱。必須提供和/或正方形行銷圖片素材資源。
squareMarketingImageAsset

string

相關正方形行銷圖片的素材資源資源名稱。必須提供和/或行銷圖片素材資源。
portraitMarketingImageAsset

string

相關聯的 4:5 直向行銷圖片素材資源資源名稱。
headline

string

必要欄位。輪轉介面資訊卡的標題。
callToActionText

string

行動號召文字。

DynamicTravelAsset

動態的旅遊素材資源。

JSON 表示法 
{
  "destinationId": string,
  "originId": string,
  "title": string,
  "destinationName": string,
  "destinationAddress": string,
  "originName": string,
  "price": string,
  "salePrice": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "category": string,
  "contextualKeywords": [
    string
  ],
  "similarDestinationIds": [
    string
  ],
  "imageUrl": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string
}
欄位
destinationId

string

必要欄位。目的地編號可以是任何一串字母和數字，而且不得重複且必須與再行銷代碼的值相符。這是必填欄位。
originId

string

起點 ID，可以是任何字母和數字的序列。ID 序列 (目的地 ID + 起點 ID) 不得重複。
title

string

必要欄位。例如：預訂火車票。這是必填欄位。
destinationName

string

目的地名稱，例如巴黎。
destinationAddress

string

可使用以下其中一種格式指定的目的地地址。(1) 城市、州/省、代碼、國家/地區，例如 Mountain View, CA, USA。(2) 完整地址，例如臺北市信義區信義路五段 7 號。(3) 以 DDD 格式顯示的經緯度，例如 41.40338, 2.17403。
originName

string

出發地名稱，例如倫敦。
price

string

價格可以是數字，後面接著字母貨幣代碼，採 ISO 4217 標準。請使用「.」做為小數點，例如「100.00 美元」。
salePrice

string

特價，可以是數字，後面加上字母貨幣代碼，採 ISO 4217 標準。請使用「.」做為小數，例如「80.00 USD」。必須小於「價格」欄位。
formattedPrice

string

格式化價格，可以是任何字元。設定後，系統就會使用這項屬性取代「price」，例如 $100.00 美元起。
formattedSalePrice

string

格式化特價，可以是任何字元。如果設定這個屬性，這項屬性就會取代「sale price [特價]」，例如「特價」為 $80.00 美元。
category

string

類別，例如「Express」。
contextualKeywords[]

string

內容比對關鍵字 (例如巴黎火車)。
similarDestinationIds[]

string

類似目的地 ID，例如「NYC」。
imageUrl

string

圖片網址，例如 http://www.example.com/image.png。系統不會上傳這張圖片做為圖片素材資源。
iosAppStoreId

string (int64 format)

iOS App Store ID。系統會先根據這個屬性檢查使用者裝置是否已經安裝了應用程式，再透過深層連結將使用者帶往到達網頁。如果設定了這個欄位，就必須一併顯示 iosAppLink 欄位。

DynamicLocalAsset

動態的本機素材資源。

JSON 表示法 
{
  "dealId": string,
  "dealName": string,
  "subtitle": string,
  "description": string,
  "price": string,
  "salePrice": string,
  "imageUrl": string,
  "address": string,
  "category": string,
  "contextualKeywords": [
    string
  ],
  "formattedPrice": string,
  "formattedSalePrice": string,
  "androidAppLink": string,
  "similarDealIds": [
    string
  ],
  "iosAppLink": string,
  "iosAppStoreId": string
}
欄位
dealId

string

必要欄位。交易 ID 可以是任何一串字母和數字，而且不得重複且必須與再行銷代碼值相符。這是必填欄位。
dealName

string

必要欄位。特惠名稱，例如「山景城」雜貨店 5 折優惠。這是必填欄位。
subtitle

string

副標題，例如雜貨。
description

string

說明，例如「享有每週帳單優惠」。
price

string

價格可以是數字，後面接著字母貨幣代碼，採 ISO 4217 標準。請使用「.」做為小數點，例如「100.00 美元」。
salePrice

string

特價，可以是數字，後面加上字母貨幣代碼，採 ISO 4217 標準。請使用「.」做為小數，例如「80.00 USD」。必須小於「價格」欄位。
imageUrl

string

圖片網址，例如 http://www.example.com/image.png。系統不會上傳這張圖片做為圖片素材資源。
address

string

可使用以下格式指定的地址。(1) 城市、州/省、代碼、國家/地區，例如 Mountain View, CA, USA。(2) 完整地址，例如臺北市信義區信義路五段 7 號。(3) 以 DDD 格式顯示的經緯度，例如 41.40338, 2.17403。
category

string

類別，例如「食物」。
contextualKeywords[]

string

內容比對關鍵字，例如「儲存雜貨優待券」。
formattedPrice

string

格式化價格，可以是任何字元。設定後，系統就會使用這項屬性取代「price」，例如 $100.00 美元起。
formattedSalePrice

string

格式化特價，可以是任何字元。如果設定這個屬性，這項屬性就會取代「sale price [特價]」，例如「特價」為 $80.00 美元。
similarDealIds[]

string

類似優惠 ID，例如「1275」。
iosAppStoreId

string (int64 format)

iOS App Store ID。系統會先根據這個屬性檢查使用者裝置是否已經安裝了應用程式，再透過深層連結將使用者帶往到達網頁。如果設定了這個欄位，就必須一併顯示 iosAppLink 欄位。

DynamicJobsAsset

動態工作資產。

JSON 表示法 
{
  "jobId": string,
  "locationId": string,
  "jobTitle": string,
  "jobSubtitle": string,
  "description": string,
  "imageUrl": string,
  "jobCategory": string,
  "contextualKeywords": [
    string
  ],
  "address": string,
  "salary": string,
  "androidAppLink": string,
  "similarJobIds": [
    string
  ],
  "iosAppLink": string,
  "iosAppStoreId": string
}
欄位
jobId

string

必要欄位。工作 ID，可以是任何一串字母和數字，而且不得重複且必須與再行銷代碼值相符。這是必填欄位。
locationId

string

地區 ID，可以是任何字母和數字的序列。ID 序列 (工作 ID + 位置 ID) 不得重複。
jobTitle

string

必要欄位。職稱，例如「軟體工程師」。這是必填欄位。
jobSubtitle

string

工作副標題，例如 Level II。
description

string

例如「應用專業技能」說明
imageUrl

string

圖片網址，例如 http://www.example.com/image.png。系統不會上傳這張圖片做為圖片素材資源。
jobCategory

string

工作類別，例如「Technical」。
contextualKeywords[]

string

內容比對關鍵字，例如「軟體工程工作」。
address

string

可使用以下格式指定的地址。(1) 城市、州/省、代碼、國家/地區，例如 Mountain View, CA, USA。(2) 完整地址，例如臺北市信義區信義路五段 7 號。(3) 以 DDD 格式顯示的經緯度，例如 41.40338, 2.17403。
salary

string

薪資，例如 $100,000 美元。
similarJobIds[]

string

類似工作 ID，例如 1275。
iosAppStoreId

string (int64 format)

iOS App Store ID。系統會先根據這個屬性檢查使用者裝置是否已經安裝了應用程式，再透過深層連結將使用者帶往到達網頁。如果設定了這個欄位，就必須一併顯示 iosAppLink 欄位。

LocationAsset

地點素材資源。

JSON 表示法 
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
欄位
placeId

string

地點 ID 可以用來辨識 Google 地點介面集資料庫和 Google 地圖中的特定地點。只能針對特定客戶 ID 和素材資源類型填寫這個欄位。請參閱 https://developers.google.com/places/web-service/place-id，進一步瞭解地點 ID。
businessProfileLocations[]

object (BusinessProfileLocation)

客戶的商家所在地點清單。只有在從商家檔案帳戶同步處理地點素材資源時，才會傳回這個值。同一個帳戶可能有多個商家檔案資訊指向同一個地點 ID。
locationOwnershipType

enum (LocationOwnershipType)

地點擁有權的類型。如果類型是「BUSINESS_OWNER」，就會以地點額外資訊的形式提供。如果類型是「聯盟」，就會做為經銷地點。

BusinessProfileLocation

從已連結的商家檔案帳戶同步處理的商家檔案位置資料。

JSON 表示法 
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
欄位
labels[]

string

廣告主為商家檔案帳戶中的地點指定的標籤。這項資訊會從商家檔案帳戶同步。
storeCode

string

這個營業地點的商家檔案商店代碼。這項資訊會從商家檔案帳戶同步。
listingId

string (int64 format)

這個商家檔案地點的商家資訊 ID。系統會從已連結的商家檔案帳戶同步處理這項資訊。

HotelPropertyAsset

飯店房源素材資源。

JSON 表示法 
{
  "placeId": string,
  "hotelAddress": string,
  "hotelName": string
}
欄位
placeId

string

地點 ID 可以用來辨識 Google 地點介面集資料庫和 Google 地圖中的特定地點。詳情請參閱 https://developers.google.com/places/web-service/place-id。
hotelAddress

string

飯店的地址，唯讀。
hotelName

string

飯店的名稱，唯讀。