- JSON 表示法
- AssetType
- AssetPolicySummary
- AssetFieldTypePolicySummary
- YoutubeVideoAsset
- MediaBundleAsset
- ImageAsset
- ImageDimension
- TextAsset
- LeadFormAsset
- LeadFormCallToActionType
- LeadFormField
- LeadFormSingleChoiceAnswers
- LeadFormCustomQuestionField
- LeadFormDeliveryMethod
- WebhookDelivery
- LeadFormPostSubmitCallToActionType
- LeadFormDesiredIntent
- BookOnGoogleAsset
- PromotionAsset
- PromotionExtensionDiscountModifier
- PromotionExtensionOccasion
- 收益
- CalloutAsset
- StructuredSnippetAsset
- SitelinkAsset
- PageFeedAsset
- DynamicEducationAsset
- MobileAppAsset
- HotelCalloutAsset
- CallAsset
- PriceAsset
- PriceExtensionType
- PriceExtensionPriceQualifier
- PriceOffering
- PriceExtensionPriceUnit
- CallToActionAsset
- DynamicRealEstateAsset
- DynamicCustomAsset
- DynamicHotelsAndRentalsAsset
- DynamicFlightsAsset
- DemandGenCarouselCardAsset
- DynamicTravelAsset
- DynamicLocalAsset
- DynamicJobsAsset
- LocationAsset
- BusinessProfileLocation
- HotelPropertyAsset
- BusinessMessageAsset
- BusinessMessageProvider
- BusinessMessageCallToActionInfo
- BusinessMessageCallToActionType
- WhatsappBusinessMessageInfo
- AppDeepLinkAsset
素材資源是廣告的一部分,可跨多個廣告共用。素材資源可以是圖片 (ImageAsset)、影片 (YoutubeVideoAsset) 等。素材資源是不可變更的,因此無法移除。如要停止放送素材資源,請從使用該素材資源的實體中移除素材資源。
JSON 表示法 |
---|
{ "resourceName": string, "type": enum ( |
欄位 | |
---|---|
resourceName |
不可變動。素材資源的資源名稱。素材資源名稱的格式如下:
|
type |
僅供輸出。素材資源類型。 |
finalUrls[] |
所有跨網域重新導向後,可能的最終到達網址清單。 |
finalMobileUrls[] |
所有跨網域重新導向後,可能的最終行動版網址清單。 |
urlCustomParameters[] |
對應項目清單,用於在 trackingUrlTemplate、finalUrls 和/或 finalMobileUrls 中替換網址自訂參數標記。 |
source |
僅供輸出。素材資源來源。 |
policySummary |
僅供輸出。資產的政策資訊。 |
fieldTypePolicySummaries[] |
僅供輸出。每個 FieldType 的素材資源政策資訊。 |
id |
僅供輸出。資產 ID。 |
name |
素材資源的選用名稱。 |
trackingUrlTemplate |
用於建構追蹤網址的網址範本。 |
finalUrlSuffix |
網址範本,可將參數附加到並行追蹤的到達網頁網址。 |
聯集欄位 asset_data 。素材資源的具體類型。asset_data 只能是下列其中一項: |
|
youtubeVideoAsset |
不可變動。YouTube 影片素材資源。 |
mediaBundleAsset |
不可變動。媒體組合素材資源。 |
imageAsset |
僅供輸出。圖片素材資源。 |
textAsset |
不可變動。文字素材資源。 |
leadFormAsset |
待開發客戶表單素材資源。 |
bookOnGoogleAsset |
透過 Google 訂房素材資源。 |
promotionAsset |
宣傳素材資源。 |
calloutAsset |
摘要素材資源。 |
structuredSnippetAsset |
網站簡介素材資源。 |
sitelinkAsset |
網站連結素材資源。 |
pageFeedAsset |
網頁動態饋給素材資源。 |
dynamicEducationAsset |
動態教育素材資源。 |
mobileAppAsset |
行動應用程式素材資源。 |
hotelCalloutAsset |
飯店摘要素材資源。 |
callAsset |
電話素材資源。 |
priceAsset |
價格素材資源。 |
callToActionAsset |
不可變動。行動號召素材資源。 |
dynamicRealEstateAsset |
動態房地產素材資源。 |
dynamicCustomAsset |
動態自訂素材資源。 |
dynamicHotelsAndRentalsAsset |
動態飯店和度假民宿素材資源。 |
dynamicFlightsAsset |
動態航班素材資源。 |
demandGenCarouselCardAsset |
不可變動。需求開發廣告的輪轉介面資訊卡素材資源。 |
dynamicTravelAsset |
動態旅遊素材資源。 |
dynamicLocalAsset |
動態當地素材資源。 |
dynamicJobsAsset |
動態職缺素材資源。 |
locationAsset |
僅供輸出。地點素材資源。 |
hotelPropertyAsset |
不可變動。飯店房源素材資源。 |
businessMessageAsset |
消費者訊息素材資源。 |
appDeepLinkAsset |
不可變動。應用程式深層連結素材資源。 |
AssetType
描述可能的資產類型的列舉。
列舉 | |
---|---|
UNSPECIFIED |
不指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本中未知的值。 |
YOUTUBE_VIDEO |
YouTube 影片素材資源。 |
MEDIA_BUNDLE |
媒體組合素材資源。 |
IMAGE |
圖片素材資源。 |
TEXT |
文字素材資源。 |
LEAD_FORM |
待開發客戶表單素材資源。 |
BOOK_ON_GOOGLE |
透過 Google 訂房素材資源。 |
PROMOTION |
宣傳素材資源。 |
CALLOUT |
摘要素材資源。 |
STRUCTURED_SNIPPET |
網站簡介素材資源。 |
SITELINK |
網站連結素材資源。 |
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 |
飯店房源素材資源。 |
DEMAND_GEN_CAROUSEL_CARD |
需求開發輪轉介面資訊卡素材資源。 |
BUSINESS_MESSAGE |
消費者訊息素材資源。 |
APP_DEEP_LINK |
應用程式深層連結素材資源。 |
AssetPolicySummary
包含資產的政策資訊。
JSON 表示法 |
---|
{ "policyTopicEntries": [ { object ( |
欄位 | |
---|---|
policyTopicEntries[] |
僅供輸出。這項資產的政策違規事項清單。 |
reviewStatus |
僅供輸出。素材資源目前處於審查程序的哪個階段。 |
approvalStatus |
僅供輸出。這個素材資源的整體核准狀態,計算方式是根據個別政策主題項目的狀態。 |
AssetFieldTypePolicySummary
包含 AssetFieldType 情境下資產的政策資訊。
JSON 表示法 |
---|
{ "assetFieldType": enum ( |
欄位 | |
---|---|
assetFieldType |
僅供輸出。這個素材資源的 FieldType。 |
assetSource |
僅供輸出。這項素材資源的來源。 |
policySummaryInfo |
僅供輸出。政策摘要。 |
YoutubeVideoAsset
YouTube 素材資源。
JSON 表示法 |
---|
{ "youtubeVideoTitle": string, "youtubeVideoId": string } |
欄位 | |
---|---|
youtubeVideoTitle |
YouTube 影片標題。 |
youtubeVideoId |
YouTube 影片 ID。這是 YouTube 影片網址中使用的 11 個字元字串值。 |
MediaBundleAsset
MediaBundle 素材資源。
JSON 表示法 |
---|
{ "data": string } |
欄位 | |
---|---|
data |
媒體組合 (ZIP 檔案) 素材資源資料。上傳的 ZIP 檔案格式取決於要使用的廣告欄位。如要進一步瞭解格式,請參閱您打算使用 MediaBundleAsset 的廣告欄位說明文件。這個欄位僅限變異。 Base64 編碼字串。 |
ImageAsset
圖片素材資源。
JSON 表示法 |
---|
{ "mimeType": enum ( |
欄位 | |
---|---|
mimeType |
圖片素材資源的 MIME 類型。 |
fullSize |
原始大小圖片的中繼資料。 |
data |
圖片的原始位元組資料。這個欄位僅限變異。 Base64 編碼字串。 |
fileSize |
圖片素材資源的檔案大小 (以位元組為單位)。 |
ImageDimension
特定大小 (原始或經過調整) 圖片的中繼資料。
JSON 表示法 |
---|
{ "heightPixels": string, "widthPixels": string, "url": string } |
欄位 | |
---|---|
heightPixels |
圖片的高度。 |
widthPixels |
圖片的寬度。 |
url |
傳回圖片高度和寬度的網址。 |
TextAsset
文字素材資源。
JSON 表示法 |
---|
{ "text": string } |
欄位 | |
---|---|
text |
文字素材資源的文字內容。 |
LeadFormAsset
待開發客戶表單素材資源。
JSON 表示法 |
---|
{ "businessName": string, "callToActionType": enum ( |
欄位 | |
---|---|
businessName |
必要欄位。所宣傳的商家名稱。 |
callToActionType |
必要欄位。預先定義的顯示文字,鼓勵使用者展開表單。 |
callToActionDescription |
必要欄位。文字清楚說明價值主張,讓使用者知道展開表單後可獲得什麼體驗。 |
headline |
必要欄位。展開式表單的標題,用於說明表單要求的內容或提供協助。 |
description |
必要欄位。詳細說明展開的表單,以便說明表單要求或提供的內容。 |
privacyPolicyUrl |
必要欄位。連結至說明廣告客戶/商家如何處理所收集資料的政策頁面。 |
fields[] |
已排序的輸入欄位清單。您可以透過重新排序問題來更新這個欄位,但無法透過新增或移除問題來更新。 |
customQuestionFields[] |
排序過的自訂問題欄位清單。每份表單最多只能有 5 個資格篩選問題。 |
deliveryMethods[] |
收集待開發客戶資料並傳送給廣告主的設定方法。只能設定一個 WebhookDelivery 方法。 |
postSubmitCallToActionType |
預先定義的顯示文字,可在使用者提交表單後鼓勵他們採取行動。 |
desiredIntent |
待開發客戶表單所選意圖,例如流量更高或更有價值。 |
postSubmitHeadline |
表單提交後顯示的文字標題,說明廣告客戶如何與使用者聯絡。 |
postSubmitDescription |
表單提交後會顯示的詳細說明,說明廣告客戶如何與使用者聯絡。 |
backgroundImageAsset |
背景圖片的素材資源名稱。圖片尺寸必須是 1200x628。 |
customDisclosure |
在待開發客戶表單中,自訂揭露資訊會與 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 ( |
欄位 | |
---|---|
inputType |
說明輸入類型,可能是預先定義的類型,例如「全名」;或是預先審查過的問題,例如「你擁有哪種類型的車輛?」 |
聯集欄位 answers 。定義這個表單欄位接受的答案設定。如果未設定 oneof,則為自由文字答案。answers 只能是下列其中一項: |
|
singleChoiceAnswers |
單選題的答案設定。只能針對經過審查的問題欄位設定。最少 2 個答案,最多 12 個。 |
hasLocationAnswer |
位置問題的答案設定。如果為 true,廣告活動/帳戶層級位置資料 (州、城市、商家名稱等) 就會顯示在待開發客戶表單上。自 13.1 版起,如果廣告主在廣告活動/帳戶層級設定了地點素材資源,則只能針對「What is your preferred dealership?」(您偏好的經銷商據點為何?) 問題設定 hasLocationAnswer。 |
LeadFormSingleChoiceAnswers
定義單選題的可能答案,通常會以單選下拉式選單的形式呈現。
JSON 表示法 |
---|
{ "answers": [ string ] } |
欄位 | |
---|---|
answers[] |
單一問題欄位的選項清單。項目的順序會定義 UI 順序。最少 2 個答案,最多 12 個。 |
LeadFormCustomQuestionField
表單中一個自訂問題輸入欄位例項。
JSON 表示法 |
---|
{ "customQuestionText": string, // Union field |
欄位 | |
---|---|
customQuestionText |
自訂問題欄位的確切文字 (例如「您有哪種車輛?」)。 |
聯集欄位 answers 。定義這個表單欄位接受的答案設定。如果未設定 oneof,則為自由文字答案。answers 只能是下列其中一項: |
|
singleChoiceAnswers |
單選題的答案設定。最少 2 個答案,最多 12 個。 |
hasLocationAnswer |
位置問題的答案設定。如果為 true,廣告活動/帳戶層級位置資料 (州、城市、商家名稱等) 就會顯示在待開發客戶表單上。自 13.1 版起,如果廣告主在廣告活動/帳戶層級設定了地點素材資源,則只能針對「What is your preferred dealership?」(您偏好的經銷商據點為何?) 問題設定 hasLocationAnswer。 |
LeadFormDeliveryMethod
設定待開發客戶如何傳送給廣告主。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 delivery_details 。各種提交類型。delivery_details 只能是下列其中一項: |
|
webhook |
Webhook 提交方式。 |
WebhookDelivery
Google 會向廣告主發出 HTTP 呼叫,通知他們有待開發客戶。要求包含與 Google 在表單廣告說明文件中發布的結構定義相符的 JSON。
JSON 表示法 |
---|
{ "advertiserWebhookUrl": string, "googleSecret": string, "payloadSchemaVersion": string } |
欄位 | |
---|---|
advertiserWebhookUrl |
廣告客戶指定用於傳送待開發客戶的 Webhook 網址。 |
googleSecret |
廣告主在 webhook 酬載中設定的防偽造金鑰。 |
payloadSchemaVersion |
這個提交例項將使用的結構定義版本。 |
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 ( |
欄位 | |
---|---|
promotionTarget |
必要欄位。說明促銷活動指定目標對象的格式不限說明。 |
discountModifier |
折扣資格的調節係數。 |
redemptionStartDate |
促銷活動的兌換開始日期,格式為 yyyy-MM-dd。 |
redemptionEndDate |
促銷活動的最後兌換期限,格式為 yyyy-MM-dd。 |
occasion |
促銷活動的適用場合。如果設定了活動,兌換期間必須落在與活動相關聯的日期範圍內。 |
languageCode |
促銷活動的語言。以 BCP 47 語言標記表示。 |
startDate |
這個素材資源生效並開始放送的開始日期,格式為 yyyy-MM-dd。 |
endDate |
此素材資源生效且仍在放送的最後日期,格式為 yyyy-MM-dd。 |
adScheduleTargets[] |
非重疊排程清單,指定資產可放送的所有時間間隔。每天最多可設定 6 個時段,總共 42 個。 |
聯集欄位 discount_type 。折扣類型,可以是折扣百分比或折扣金額。discount_type 只能是下列其中一項: |
|
percentOff |
促銷活動的折扣百分比。1,000,000 = 100%。必須提供這個屬性或 moneyAmountOff。 |
moneyAmountOff |
促銷活動的折扣金額。必須提供這個或 percentOff。 |
聯集欄位 promotion_trigger 。促銷活動觸發條件。可以是促銷代碼,也可以是符合資格的訂單金額促銷活動。promotion_trigger 只能是下列其中一項: |
|
promotionCode |
使用者必須輸入這組代碼,才能符合促銷活動資格。 |
ordersOverAmount |
使用者必須達到這個金額,才能符合促銷資格。 |
PromotionExtensionDiscountModifier
促銷活動額外資訊的折扣調節係數。
列舉 | |
---|---|
UNSPECIFIED |
不指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本中未知的值。 |
UP_TO |
「最多」 |
PromotionExtensionOccasion
促銷額外資訊的場合。
列舉 | |
---|---|
UNSPECIFIED |
不指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本中未知的值。 |
NEW_YEARS |
新年。 |
CHINESE_NEW_YEAR |
農曆新年。 |
VALENTINES_DAY |
情人節。 |
EASTER |
復活節。 |
MOTHERS_DAY |
母親節。 |
FATHERS_DAY |
父親節。 |
LABOR_DAY |
勞動節。 |
BACK_TO_SCHOOL |
開學季。 |
HALLOWEEN |
萬聖節。 |
BLACK_FRIDAY |
黑色星期五。 |
CYBER_MONDAY |
網購星期一 (Cyber Monday)。 |
CHRISTMAS |
聖誕節。 |
BOXING_DAY |
節禮日。 |
INDEPENDENCE_DAY |
任何國家/地區的獨立紀念日。 |
NATIONAL_DAY |
任何國家/地區的國慶日。 |
END_OF_SEASON |
任何季節結束。 |
WINTER_SALE |
冬季促銷。 |
SUMMER_SALE |
夏季促銷。 |
FALL_SALE |
秋季促銷。 |
SPRING_SALE |
春季促銷。 |
RAMADAN |
齋戒月。 |
EID_AL_FITR |
開齋節。 |
EID_AL_ADHA |
宰牲節。 |
SINGLES_DAY |
光棍節。 |
WOMENS_DAY |
婦女節。 |
HOLI |
五彩節。 |
PARENTS_DAY |
家長節。 |
ST_NICHOLAS_DAY |
聖尼可拉斯節。 |
CARNIVAL |
嘉年華。 |
EPIPHANY |
主顯節,又稱為三王節。 |
ROSH_HASHANAH |
猶太教新年。 |
PASSOVER |
逾越節。 |
HANUKKAH |
光明節。 |
DIWALI |
排燈節。 |
NAVRATRI |
九夜節。 |
SONGKRAN |
泰文:Songkran。 |
YEAR_END_GIFT |
日文:年終送禮。 |
金額
代表特定貨幣的價格。
JSON 表示法 |
---|
{ "currencyCode": string, "amountMicros": string } |
欄位 | |
---|---|
currencyCode |
由三個字元組成的 ISO 4217 貨幣代碼。 |
amountMicros |
金額 (以百萬分之一為單位)。一百萬等於一個單位。 |
CalloutAsset
摘要素材資源。
JSON 表示法 |
---|
{
"calloutText": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
欄位 | |
---|---|
calloutText |
必要欄位。摘要文字。這個字串的長度應介於 1 到 25 之間 (含首尾)。 |
startDate |
這個素材資源生效並開始放送的開始日期,格式為 yyyy-MM-dd。 |
endDate |
此素材資源生效且仍在放送的最後日期,格式為 yyyy-MM-dd。 |
adScheduleTargets[] |
非重疊排程清單,指定資產可放送的所有時間間隔。每天最多可設定 6 個時段,總共 42 個。 |
StructuredSnippetAsset
網站簡介素材資源。
JSON 表示法 |
---|
{ "header": string, "values": [ string ] } |
欄位 | |
---|---|
header |
必要欄位。簡介的標頭。這個字串應為 https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers 中預先定義的值之一 |
values[] |
必要欄位。程式碼片段中的值。這個集合的大小應介於 3 到 10 之間 (含首尾)。每個值的長度應介於 1 至 25 個半形字元之間 (含頭尾)。 |
SitelinkAsset
網站連結素材資源。
JSON 表示法 |
---|
{
"linkText": string,
"description1": string,
"description2": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
欄位 | |
---|---|
linkText |
必要欄位。網站連結的網址顯示文字。這個字串的長度應介於 1 到 25 之間 (含首尾)。 |
description1 |
網站連結說明的第一行。如果已設定,長度應介於 1 至 35 之間 (含首尾),且必須一併設定 description2。 |
description2 |
網站連結說明的第二行。如果已設定,長度應介於 1 至 35 之間 (含首尾),且必須一併設定 description1。 |
startDate |
這個素材資源生效並開始放送的開始日期,格式為 yyyy-MM-dd。 |
endDate |
此素材資源生效且仍在放送的最後日期,格式為 yyyy-MM-dd。 |
adScheduleTargets[] |
非重疊排程清單,指定資產可放送的所有時間間隔。每天最多可設定 6 個時段,總共 42 個。 |
PageFeedAsset
網頁動態饋給素材資源。
JSON 表示法 |
---|
{ "pageUrl": string, "labels": [ string ] } |
欄位 | |
---|---|
pageUrl |
必要欄位。廣告客戶要指定的網頁。 |
labels[] |
用於將網頁網址分組的標籤。 |
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 |
必要欄位。可使用任意字母和數字組成的任何序列,且必須不重複,且必須與再行銷標記的值一致。必填。 |
locationId |
Location ID 可由任意字母和數字組成,且不得重複。 |
programName |
必要欄位。課程名稱,例如護理。必填。 |
subject |
研究主題,例如健康。 |
programDescription |
課程說明,例如護理證照。 |
schoolName |
學校名稱,例如 Mountain View School of Nursing。 |
address |
學校地址,可使用下列任一格式指定。(1) 城市、州/省、代碼、國家/地區,例如美國加州山景城。(2) 完整地址,例如 123 Boulevard St, Mountain View, CA 94043。(3) 經緯度 (格式為 DDD),例如 41.40338, 2.17403 |
contextualKeywords[] |
內容比對關鍵字,例如 Nursing certification、Health、Mountain View。 |
androidAppLink |
Android 深層連結,例如 android-app://com.example.android/http/example.com/gizmos?1234。 |
similarProgramIds[] |
類似課程 ID。 |
iosAppLink |
iOS 深層連結,例如 exampleApp://content/page。 |
iosAppStoreId |
iOS App Store ID。系統會先根據這個屬性檢查使用者裝置是否已經安裝了應用程式,再透過深層連結將使用者帶往到達網頁。如果設定這個欄位,就必須一併提供 iosAppLink 欄位。 |
thumbnailImageUrl |
縮圖網址,例如 http://www.example.com/thumbnail.png。系統不會將縮圖圖片上傳為圖片素材資源。 |
imageUrl |
圖片網址,例如 http://www.example.com/image.png。系統不會將圖片上傳為圖片素材資源。 |
MobileAppAsset
代表行動應用程式的素材資源。
JSON 表示法 |
---|
{
"appId": string,
"appStore": enum ( |
欄位 | |
---|---|
appId |
必要欄位。用於唯一識別行動應用程式的字串。應只包含平台原生 ID,例如 Android 的「com.android.ebay」或 iOS 的「12345689」。 |
appStore |
必要欄位。發布此特定應用程式的應用程式商店。 |
linkText |
必要欄位。連結在廣告中顯示時,會顯示的文字。這個字串的長度應介於 1 到 25 之間 (含首尾)。 |
startDate |
這個素材資源生效並開始放送的開始日期,格式為 yyyy-MM-dd。 |
endDate |
此素材資源生效且仍在放送的最後日期,格式為 yyyy-MM-dd。 |
HotelCalloutAsset
代表飯店摘要的素材資源。
JSON 表示法 |
---|
{ "text": string, "languageCode": string } |
欄位 | |
---|---|
text |
必要欄位。飯店摘要素材資源的文字。這個字串的長度應介於 1 到 25 之間 (含首尾)。 |
languageCode |
必要欄位。飯店摘要的語言。以 BCP 47 語言標記表示。 |
CallAsset
電話素材資源。
JSON 表示法 |
---|
{ "countryCode": string, "phoneNumber": string, "callConversionReportingState": enum ( |
欄位 | |
---|---|
countryCode |
必要欄位。電話號碼的國家/地區代碼 (由兩個英文字母組成)。例如:'US'、'us'。 |
phoneNumber |
必要欄位。廣告主的原始電話號碼。範例:「1234567890」、「(123)456-7890」 |
callConversionReportingState |
指出這個 CallAsset 應使用自身的來電轉換設定、遵循帳戶層級設定,還是停用來電轉換。 |
callConversionAction |
要歸因於來電轉換的轉換動作。如未設定,系統會使用預設轉換動作。只有在 callConversionReportingState 設為 USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION 時,這個欄位才會生效。 |
adScheduleTargets[] |
非重疊排程清單,指定資產可放送的所有時間間隔。每天最多可設定 6 個時段,總共 42 個。 |
PriceAsset
代表價格優惠清單的素材資源。
JSON 表示法 |
---|
{ "type": enum ( |
欄位 | |
---|---|
type |
必要欄位。價格素材資源的類型。 |
priceQualifier |
價格素材資源的價格條件。 |
languageCode |
必要欄位。價格素材資源的語言。以 BCP 47 語言標記表示。 |
priceOfferings[] |
價格素材資源的價格方案。這個集合的大小應介於 3 到 8 之間 (含首尾)。 |
PriceExtensionType
價格額外資訊類型。
列舉 | |
---|---|
UNSPECIFIED |
不指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本中未知的值。 |
BRANDS |
顯示品牌清單的類型。 |
EVENTS |
顯示事件清單的類型。 |
LOCATIONS |
顯示與商家相關的地區類型。 |
NEIGHBORHOODS |
顯示城市或區域內子區或區域的類型。 |
PRODUCT_CATEGORIES |
顯示產品類別集合的類型。 |
PRODUCT_TIERS |
用於顯示相關產品層級集合的類型。 |
SERVICES |
用於顯示貴商家提供的服務集合類型。 |
SERVICE_CATEGORIES |
顯示服務類別集合的類型。 |
SERVICE_TIERS |
用於顯示相關服務層級集合的類型。 |
PriceExtensionPriceQualifier
價格額外資訊價格條件的列舉。
列舉 | |
---|---|
UNSPECIFIED |
不指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本中未知的值。 |
FROM |
價格的「最低」條件。 |
UP_TO |
價格的「最高」條件。 |
AVERAGE |
價格的「平均」條件。 |
PriceOffering
PriceAsset 中的單一價格商品。
JSON 表示法 |
---|
{ "header": string, "description": string, "price": { object ( |
欄位 | |
---|---|
header |
必要欄位。價格方案的標題。這個字串的長度應介於 1 到 25 之間 (含首尾)。 |
description |
必要欄位。價格方案的說明。這個字串的長度應介於 1 到 25 之間 (含首尾)。 |
price |
必要欄位。價格商品的價格值。 |
unit |
價格方案的價格單位。 |
finalUrl |
必要欄位。所有跨網域重新導向後的最終到達網址。 |
finalMobileUrl |
所有跨網域重新導向後的最終行動版網址。 |
PriceExtensionPriceUnit
價格額外資訊的價格單位。
列舉 | |
---|---|
UNSPECIFIED |
不指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本中未知的值。 |
PER_HOUR |
每小時。 |
PER_DAY |
每天。 |
PER_WEEK |
每週。 |
PER_MONTH |
每月。 |
PER_YEAR |
每年。 |
PER_NIGHT |
每晚。 |
CallToActionAsset
行動號召素材資源。
JSON 表示法 |
---|
{
"callToAction": enum ( |
欄位 | |
---|---|
callToAction |
行動號召。 |
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 |
必要欄位。房源 ID 可為任何英文字母和數字組合,且不得重複,且必須與再行銷標記的值一致。必填。 |
listingName |
必要欄位。商家名稱,例如 Boulevard Bungalow。必填。 |
cityName |
城市名稱,例如加州山景城。 |
description |
說明,例如 3 房、2 衛浴、1568 平方英尺 |
address |
地址可使用下列任一格式指定。(1) 城市、州/省、代碼、國家/地區,例如美國加州山景城。(2) 完整地址,例如 123 Boulevard St, Mountain View, CA 94043。(3) 經緯度 (格式為 DDD),例如 41.40338, 2.17403 |
price |
價格可為數字,後方加上以英文字母構成的貨幣代碼 (需符合 ISO 4217 標準);請使用「.」做為小數點符號,例如 200,000.00 美元。 |
imageUrl |
圖片網址,例如 http://www.example.com/image.png。系統不會將圖片上傳為圖片素材資源。 |
propertyType |
房源類型,例如 House。 |
listingType |
房源類型,例如待售。 |
contextualKeywords[] |
內容比對關鍵字,例如 For sale; Houses for sale。 |
formattedPrice |
格式化的價格,可使用任何字元。如果已設定,系統會使用這項屬性,而非「price」,例如「Starting at $200,000.00」。 |
androidAppLink |
Android 深層連結,例如 android-app://com.example.android/http/example.com/gizmos?1234。 |
iosAppLink |
iOS 深層連結,例如 exampleApp://content/page。 |
iosAppStoreId |
iOS App Store ID。系統會先根據這個屬性檢查使用者裝置是否已經安裝了應用程式,再透過深層連結將使用者帶往到達網頁。如果設定這個欄位,就必須一併提供 iosAppLink 欄位。 |
similarListingIds[] |
類似房源 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 |
必要欄位。ID 可以是任何英文字母和數字組合,且不得重複,且必須與再行銷標記的值一致,例如 sedan。必填。 |
id2 |
ID2 可以是任意字母和數字的排列組合,例如 red。ID 序列 (ID + ID2) 不得重複。 |
itemTitle |
必要欄位。商品名稱,例如「Mid-size sedan」。必填。 |
itemSubtitle |
商品副標題,例如「在山景城的經銷商」。 |
itemDescription |
商品說明,例如「最暢銷的中型車」。 |
itemAddress |
商品地址,可使用下列任一格式指定。(1) 城市、州/省、代碼、國家/地區,例如美國加州山景城。(2) 完整地址,例如 123 Boulevard St, Mountain View, CA 94043。(3) 經緯度 (格式為 DDD),例如 41.40338, 2.17403 |
itemCategory |
項目類別,例如轎車。 |
price |
價格可為數字,後方加上以英文字母構成的貨幣代碼 (需符合 ISO 4217 標準);請使用「.」做為小數點符號,例如 $20,000.00 美元。 |
salePrice |
售價,可為數字,後方加上以英文字母構成的貨幣代碼 (需符合 ISO 4217 標準);請使用「.」做為小數點符號,例如 15,000.00 美元。必須小於「price」欄位。 |
formattedPrice |
格式化的價格,可使用任何字元。如果已設定,系統會使用這項屬性,而非「price」,例如「Starting at $20,000.00」。 |
formattedSalePrice |
格式化特價,可包含任何字元。如果設定了這項屬性,系統會使用這項屬性取代「特價」,例如「特價 $15,000.00」。 |
imageUrl |
圖片網址,例如 http://www.example.com/image.png。系統不會將圖片上傳為圖片素材資源。 |
contextualKeywords[] |
內容比對關鍵字,例如 Sedans、4 door sedans。 |
androidAppLink |
Android 深層連結,例如 android-app://com.example.android/http/example.com/gizmos?1234。 |
iosAppLink |
iOS 深層連結,例如 exampleApp://content/page。 |
iosAppStoreId |
iOS App Store ID。系統會先根據這個屬性檢查使用者裝置是否已經安裝了應用程式,再透過深層連結將使用者帶往到達網頁。如果設定這個欄位,就必須一併提供 iosAppLink 欄位。 |
similarIds[] |
類似 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 |
必要欄位。房源 ID 可為任意字母和數字序列,且不得重複,且必須與再行銷標記的值一致。必填。 |
propertyName |
必要欄位。房源名稱,例如 Mountain View Hotel。必填。 |
imageUrl |
圖片網址,例如 http://www.example.com/image.png。系統不會將圖片上傳為圖片素材資源。 |
destinationName |
目的地名稱,例如「山景城市中心」。 |
description |
說明,例如「靠近 SJC 機場」。 |
price |
價格可為數字,後方加上以英文字母構成的貨幣代碼 (需符合 ISO 4217 標準);請使用「.」做為小數點符號,例如 $100.00 美元。 |
salePrice |
ISO 4217 標準。請使用「.」做為小數點符號,例如 80.00 USD。必須小於「price」欄位。 |
starRating |
星級評等。必須是介於 1 到 5 之間的數字 (含 1 和 5)。 |
category |
類別,例如飯店套房。 |
contextualKeywords[] |
內容比對關鍵字,例如 Mountain View "Hotels"、South Bay hotels。 |
address |
地址可使用下列任一格式指定。(1) 城市、州/省、代碼、國家/地區,例如美國加州山景城。(2) 完整地址,例如 123 Boulevard St, Mountain View, CA 94043。(3) 經緯度 (格式為 DDD),例如 41.40338, 2.17403 |
androidAppLink |
Android 深層連結,例如 android-app://com.example.android/http/example.com/gizmos?1234。 |
iosAppLink |
iOS 深層連結,例如 exampleApp://content/page。 |
iosAppStoreId |
iOS App Store ID。系統會先根據這個屬性檢查使用者裝置是否已經安裝了應用程式,再透過深層連結將使用者帶往到達網頁。如果設定這個欄位,就必須一併提供 iosAppLink 欄位。 |
formattedPrice |
格式化的價格,可使用任何字元。如果已設定,系統會使用這項屬性而非「price」,例如「Starting at $100.00」。 |
formattedSalePrice |
格式化特價,可包含任何字元。如果設定了這項屬性,系統會使用這項屬性取代「特價」,例如「特價 $80.00」。 |
similarPropertyIds[] |
類似物業 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 |
必要欄位。目的地 ID 可以是任何英文字母和數字組合,且不得重複,且必須與再行銷標記的值一致。必填。 |
originId |
來源 ID,可由任意順序的字母和數字組成。ID 序列 (destination ID + origin ID) 不得重複。 |
flightDescription |
必要欄位。航班說明,例如「預訂機票」。必填。 |
imageUrl |
圖片網址,例如 http://www.example.com/image.png。系統不會將圖片上傳為圖片素材資源。 |
destinationName |
目的地名稱,例如巴黎。 |
originName |
起點名稱,例如倫敦。 |
flightPrice |
航班價格,可為數字,後方加上以英文字母構成的貨幣代碼 (需符合 ISO 4217 標準);請使用「.」做為小數點符號,例如 $100.00 美元。 |
flightSalePrice |
航班特價,可使用數字加上以英文字母組成的貨幣代碼 (需符合 ISO 4217 標準);請使用「.」做為小數點符號,例如 80.00 USD。必須小於「flightPrice」欄位。 |
formattedPrice |
格式化的價格,可使用任何字元。如果已設定,系統會使用這項屬性而非「price」,例如「Starting at $100.00」。 |
formattedSalePrice |
格式化特價,可包含任何字元。如果設定了這項屬性,系統會使用這項屬性取代「特價」,例如「特價 $80.00」。 |
androidAppLink |
Android 深層連結,例如 android-app://com.example.android/http/example.com/gizmos?1234。 |
iosAppLink |
iOS 深層連結,例如 exampleApp://content/page。 |
iosAppStoreId |
iOS App Store ID。系統會先根據這個屬性檢查使用者裝置是否已經安裝了應用程式,再透過深層連結將使用者帶往到達網頁。如果設定這個欄位,就必須一併提供 iosAppLink 欄位。 |
similarDestinationIds[] |
類似目的地 ID,例如 PAR、LON。 |
customMapping |
自訂欄位可包含多個鍵/值對應,並以分隔符號 (「,」, 「|」和「:」) 分隔,格式為「 |
DemandGenCarouselCardAsset
需求開發輪轉介面資訊卡素材資源。
JSON 表示法 |
---|
{ "marketingImageAsset": string, "squareMarketingImageAsset": string, "portraitMarketingImageAsset": string, "headline": string, "callToActionText": string } |
欄位 | |
---|---|
marketingImageAsset |
相關聯的 1.91:1 行銷圖片的素材資源名稱。這項和/或正方形行銷圖片素材資源為必填欄位。 |
squareMarketingImageAsset |
相關正方形行銷圖片的素材資源名稱。此圖片素材資源和/或行銷圖片素材資源為必填欄位。 |
portraitMarketingImageAsset |
相關聯的 4:5 直向行銷圖片的素材資源名稱。 |
headline |
必要欄位。輪轉介面資訊卡的標題。 |
callToActionText |
行動號召文字。 |
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 |
必要欄位。目的地 ID 可以是任何英文字母和數字組合,且不得重複,且必須與再行銷標記的值一致。必填。 |
originId |
來源 ID,可由任意順序的字母和數字組成。ID 序列 (destination ID + origin ID) 不得重複。 |
title |
必要欄位。標題,例如「預訂火車票」。必填。 |
destinationName |
目的地名稱,例如巴黎。 |
destinationAddress |
可使用下列任一格式指定的目的地址。(1) 城市、州/省、代碼、國家/地區,例如美國加州山景城。(2) 完整地址,例如 123 Boulevard St, Mountain View, CA 94043。(3) 經緯度 (格式為 DDD),例如 41.40338, 2.17403。 |
originName |
起點名稱,例如倫敦。 |
price |
價格可以是數字,後方加上以英文字母構成的貨幣代碼 (需符合 ISO 4217 標準);請使用「.」做為小數點符號,例如 $100.00 美元。 |
salePrice |
售價,可為數字,後方加上以英文字母構成的貨幣代碼 (需符合 ISO 4217 標準);請使用「.」做為小數點符號,例如 80.00 USD。必須小於「price」欄位。 |
formattedPrice |
格式化的價格,可使用任何字元。如果已設定,系統會使用這項屬性而非「price」,例如「Starting at $100.00」。 |
formattedSalePrice |
格式化特價,可包含任何字元。如果設定了這項屬性,系統會使用這項屬性取代「特價」,例如「特價 $80.00」。 |
category |
類別,例如 Express。 |
contextualKeywords[] |
內容比對關鍵字,例如巴黎火車。 |
similarDestinationIds[] |
類似目的地 ID,例如 NYC。 |
imageUrl |
圖片網址,例如 http://www.example.com/image.png。系統不會將圖片上傳為圖片素材資源。 |
androidAppLink |
Android 深層連結,例如 android-app://com.example.android/http/example.com/gizmos?1234。 |
iosAppLink |
iOS 深層連結,例如 exampleApp://content/page。 |
iosAppStoreId |
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 |
必要欄位。優惠 ID 可以是任何字母和數字序列,且不得重複,且必須與再行銷標記的值一致。必填。 |
dealName |
必要欄位。優惠名稱,例如「Mountain View Grocers 8 折」必填。 |
subtitle |
副標題,例如「雜貨」。 |
description |
說明,例如「節省每週帳單費用」。 |
price |
價格可以是數字,後方加上以英文字母構成的貨幣代碼 (需符合 ISO 4217 標準);請使用「.」做為小數點符號,例如 $100.00 美元。 |
salePrice |
售價,可為數字,後方加上以英文字母構成的貨幣代碼 (需符合 ISO 4217 標準);請使用「.」做為小數點符號,例如 80.00 USD。必須小於「price」欄位。 |
imageUrl |
圖片網址,例如 http://www.example.com/image.png。系統不會將圖片上傳為圖片素材資源。 |
address |
地址可使用下列任一格式指定。(1) 城市、州/省、代碼、國家/地區,例如美國加州山景城。(2) 完整地址,例如 123 Boulevard St, Mountain View, CA 94043。(3) 經緯度 (格式為 DDD),例如 41.40338, 2.17403。 |
category |
類別,例如「美食」。 |
contextualKeywords[] |
內容比對關鍵字,例如 Save groceries coupons。 |
formattedPrice |
格式化的價格,可使用任何字元。如果已設定,系統會使用這項屬性而非「price」,例如「Starting at $100.00」。 |
formattedSalePrice |
格式化特價,可包含任何字元。如果設定了這項屬性,系統會使用這項屬性取代「特價」,例如「特價 $80.00」。 |
androidAppLink |
Android 深層連結,例如 android-app://com.example.android/http/example.com/gizmos?1234。 |
similarDealIds[] |
類似優惠 ID,例如 1275。 |
iosAppLink |
iOS 深層連結,例如 exampleApp://content/page。 |
iosAppStoreId |
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 |
必要欄位。工作 ID 可為任意字母和數字序列,且不得重複,且必須與再行銷標記的值一致。必填。 |
locationId |
地點 ID 可由任意順序的字母和數字組成。ID 序列 (工作 ID + 位置 ID) 不得重複。 |
jobTitle |
必要欄位。工作職稱,例如「軟體工程師」。必填。 |
jobSubtitle |
工作副標題,例如「Level II」。 |
description |
說明,例如:Apply your technical skills。 |
imageUrl |
圖片網址,例如 http://www.example.com/image.png。系統不會將圖片上傳為圖片素材資源。 |
jobCategory |
工作類別,例如技術。 |
contextualKeywords[] |
內容比對關鍵字,例如軟體工程師職缺。 |
address |
地址可使用下列任一格式指定。(1) 城市、州/省、代碼、國家/地區,例如美國加州山景城。(2) 完整地址,例如 123 Boulevard St, Mountain View, CA 94043。(3) 經緯度 (格式為 DDD),例如 41.40338, 2.17403。 |
salary |
薪資,例如 $100,000 美元。 |
androidAppLink |
Android 深層連結,例如 android-app://com.example.android/http/example.com/gizmos?1234。 |
similarJobIds[] |
類似工作 ID,例如 1275。 |
iosAppLink |
iOS 深層連結,例如 exampleApp://content/page。 |
iosAppStoreId |
iOS App Store ID。系統會先根據這個屬性檢查使用者裝置是否已經安裝了應用程式,再透過深層連結將使用者帶往到達網頁。如果設定這個欄位,就必須一併提供 iosAppLink 欄位。 |
LocationAsset
地點素材資源。
JSON 表示法 |
---|
{ "placeId": string, "businessProfileLocations": [ { object ( |
欄位 | |
---|---|
placeId |
地點 ID 可以用來辨識 Google 地點介面集資料庫和 Google 地圖中的特定地點。此欄位在指定客戶 ID 和資產類型中是唯一的。請參閱 https://developers.google.com/places/web-service/place-id,進一步瞭解地點 ID。 |
businessProfileLocations[] |
客戶的商家地點清單。只有在地點素材資源從商家檔案帳戶同步時,系統才會傳回這項資料。同一個帳戶下可包含多個商家檔案資訊,且這些資訊都會指向相同的地點 ID。 |
locationOwnershipType |
地點擁有權類型。如果類型為 BUSINESS_OWNER,就會以地點額外資訊的形式放送。如果類型為 AFFILIATE,則會做為聯盟位置放送。 |
BusinessProfileLocation
從已連結的商家檔案帳戶同步的資料。
JSON 表示法 |
---|
{ "labels": [ string ], "storeCode": string, "listingId": string } |
欄位 | |
---|---|
labels[] |
廣告主在商家檔案帳戶中指定的地點標籤。這項資訊會從商家檔案帳戶同步。 |
storeCode |
這個地點的商家檔案商店代碼。這項資訊會從商家檔案帳戶同步。 |
listingId |
這個商家檔案地點的刊登 ID。這項資訊會從已連結的商家檔案帳戶同步。 |
HotelPropertyAsset
飯店房源素材資源。
JSON 表示法 |
---|
{ "placeId": string, "hotelAddress": string, "hotelName": string } |
欄位 | |
---|---|
placeId |
地點 ID 可以用來辨識 Google 地點介面集資料庫和 Google 地圖中的特定地點。詳情請參閱 https://developers.google.com/places/web-service/place-id。 |
hotelAddress |
飯店的地址。唯讀。 |
hotelName |
飯店名稱。唯讀。 |
BusinessMessageAsset
消費者訊息素材資源。
JSON 表示法 |
---|
{ "messageProvider": enum ( |
欄位 | |
---|---|
messageProvider |
必要欄位。消費者訊息素材資源的訊息供應者。 |
starterMessage |
必要欄位。歡迎訊息,提示使用者發起對話。 |
callToAction |
消費者訊息素材資源的行動號召。 |
聯集欄位 message_provider_data 。用於傳送訊息的訊息供應商資訊。message_provider_data 只能是下列其中一項: |
|
whatsappInfo |
WhatsApp。 |
BusinessMessageProvider
商家訊息供應者類型的可能值。
列舉 | |
---|---|
UNSPECIFIED |
不指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本中未知的值。 |
WHATSAPP |
WhatsApp 訊息供應端 |
BusinessMessageCallToActionInfo
顯示鼓勵使用者採取行動的資訊。
JSON 表示法 |
---|
{
"callToActionSelection": enum ( |
欄位 | |
---|---|
callToActionSelection |
必要欄位。預先定義的行動號召文字。 |
callToActionDescription |
必要欄位。文字提供明確的價值主張,說明使用者採取行動後可獲得的預期效益。例如:「請傳送訊息給我們,以便提供報價」或「請諮詢我們的專家團隊」。 |
BusinessMessageCallToActionType
列舉,說明商家訊息中的行動號召詞組類型。
列舉 | |
---|---|
UNSPECIFIED |
不指定。 |
UNKNOWN |
僅用於傳回值。代表這個版本中未知的值。 |
APPLY_NOW |
立即申請。 |
BOOK_NOW |
立即預訂。 |
CONTACT_US |
與我們聯絡。 |
GET_INFO |
取得資訊。 |
GET_OFFER |
取得優惠。 |
GET_QUOTE |
取得報價。 |
GET_STARTED |
開始使用。 |
LEARN_MORE |
瞭解詳情。 |
WhatsappBusinessMessageInfo
用於傳送訊息的 WhatsApp 資訊。
JSON 表示法 |
---|
{ "countryCode": string, "phoneNumber": string } |
欄位 | |
---|---|
countryCode |
必要欄位。電話號碼的國家/地區代碼 (由兩個英文字母組成)。例如:'US'、'us'。 |
phoneNumber |
必要欄位。商家的 WhatsApp 電話號碼。範例:「1234567890」、「(123)456-7890」。 |
AppDeepLinkAsset
應用程式深層連結素材資源
JSON 表示法 |
---|
{ "appDeepLinkUri": string } |
欄位 | |
---|---|
appDeepLinkUri |
應用程式深層連結的 uri,該 uri 可以是自訂配置 uri (例如 mystore://shoes) 或通用 uri (例如 http://www.mystore.com/shoes)。 |