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)
  },
  "demandGenCarouselCardAsset": {
    object (DemandGenCarouselCardAsset)
  },
  "dynamicTravelAsset": {
    object (DynamicTravelAsset)
  },
  "dynamicLocalAsset": {
    object (DynamicLocalAsset)
  },
  "dynamicJobsAsset": {
    object (DynamicJobsAsset)
  },
  "locationAsset": {
    object (LocationAsset)
  },
  "hotelPropertyAsset": {
    object (HotelPropertyAsset)
  },
  "businessMessageAsset": {
    object (BusinessMessageAsset)
  },
  "appDeepLinkAsset": {
    object (AppDeepLinkAsset)
  }
  // End of list of possible types for union field asset_data.
}
欄位
resourceName

string

不可變動。素材資源的資源名稱。素材資源名稱的格式如下:

customers/{customerId}/assets/{assetId}

type

enum (AssetType)

僅供輸出。素材資源類型。

finalUrls[]

string

所有跨網域重新導向後,可能的最終到達網址清單。

finalMobileUrls[]

string

所有跨網域重新導向後,可能的最終行動版網址清單。

urlCustomParameters[]

object (CustomParameter)

對應項目清單,用於在 trackingUrlTemplate、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)

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

businessMessageAsset

object (BusinessMessageAsset)

消費者訊息素材資源。

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 飯店房源素材資源。
BUSINESS_MESSAGE 消費者訊息素材資源。

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。定義這個表單欄位接受的答案設定。如果未設定 oneof,則為自由文字答案。answers 只能是下列其中一項:
singleChoiceAnswers

object (LeadFormSingleChoiceAnswers)

單選題的答案設定。只能針對經過審查的問題欄位設定。最少 2 個答案,最多 12 個。

hasLocationAnswer

boolean

位置問題的答案設定。如果為 true,廣告活動/帳戶層級位置資料 (州、城市、商家名稱等) 就會顯示在待開發客戶表單上。自 13.1 版起,如果廣告主在廣告活動/帳戶層級設定了地點素材資源,則只能針對「What is your preferred dealership?」(您偏好的經銷商據點為何?) 問題設定 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。定義這個表單欄位接受的答案設定。如果未設定 oneof,則為自由文字答案。answers 只能是下列其中一項:
singleChoiceAnswers

object (LeadFormSingleChoiceAnswers)

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

hasLocationAnswer

boolean

位置問題的答案設定。如果為 true,廣告活動/帳戶層級位置資料 (州、城市、商家名稱等) 就會顯示在待開發客戶表單上。自 13.1 版起,如果廣告主在廣告活動/帳戶層級設定了地點素材資源,則只能針對「What is your preferred dealership?」(您偏好的經銷商據點為何?) 問題設定 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 呼叫,通知他們有待開發客戶。要求包含與 Google 在表單廣告說明文件中發布的結構定義相符的 JSON。

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%。必須提供這個屬性或 moneyAmountOff。

moneyAmountOff

object (Money)

促銷活動的折扣金額。必須提供這個或 percentOff。

聯集欄位 promotion_trigger。促銷活動觸發條件。可以是促銷代碼,也可以是符合資格的訂單金額促銷活動。promotion_trigger 只能是下列其中一項:
promotionCode

string

使用者必須輸入這組代碼,才能符合促銷活動資格。

ordersOverAmount

object (Money)

使用者必須達到這個金額,才能符合促銷資格。

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

string

由三個字元組成的 ISO 4217 貨幣代碼。

amountMicros

string (int64 format)

金額 (以百萬分之一為單位)。一百萬等於一個單位。

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)
    }
  ]
}
欄位
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

Location ID 可由任意字母和數字組成,且不得重複。

programName

string

必要欄位。課程名稱,例如護理。必填。

subject

string

研究主題,例如健康。

programDescription

string

課程說明,例如護理證照。

schoolName

string

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

address

string

學校地址,可使用下列任一格式指定。(1) 城市、州/省、代碼、國家/地區,例如美國加州山景城。(2) 完整地址,例如 123 Boulevard St, Mountain View, CA 94043。(3) 經緯度 (格式為 DDD),例如 41.40338, 2.17403

contextualKeywords[]

string

內容比對關鍵字,例如 Nursing certification、Health、Mountain View。

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,例如 Android 的「com.android.ebay」或 iOS 的「12345689」。

appStore

enum (MobileAppVendor)

必要欄位。發布此特定應用程式的應用程式商店。

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 之間 (含首尾)。

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 (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

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

PriceExtensionPriceUnit

價格額外資訊的價格單位。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
PER_HOUR 每小時。
PER_DAY 每天。
PER_WEEK 每週。
PER_MONTH 每月。
PER_YEAR 每年。
PER_NIGHT 每晚。

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) 城市、州/省、代碼、國家/地區,例如美國加州山景城。(2) 完整地址,例如 123 Boulevard St, Mountain View, CA 94043。(3) 經緯度 (格式為 DDD),例如 41.40338, 2.17403

price

string

價格可為數字,後方加上以英文字母構成的貨幣代碼 (需符合 ISO 4217 標準);請使用「.」做為小數點符號,例如 200,000.00 美元。

imageUrl

string

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

propertyType

string

房源類型,例如 House。

listingType

string

房源類型,例如待售。

contextualKeywords[]

string

內容比對關鍵字,例如 For sale; Houses for sale。

formattedPrice

string

格式化的價格,可使用任何字元。如果已設定,系統會使用這項屬性,而非「price」,例如「Starting at $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 可以是任意字母和數字的排列組合,例如 red。ID 序列 (ID + ID2) 不得重複。

itemTitle

string

必要欄位。商品名稱,例如「Mid-size sedan」。必填。

itemSubtitle

string

商品副標題,例如「在山景城的經銷商」。

itemDescription

string

商品說明,例如「最暢銷的中型車」。

itemAddress

string

商品地址,可使用下列任一格式指定。(1) 城市、州/省、代碼、國家/地區,例如美國加州山景城。(2) 完整地址,例如 123 Boulevard St, Mountain View, CA 94043。(3) 經緯度 (格式為 DDD),例如 41.40338, 2.17403

itemCategory

string

項目類別,例如轎車。

price

string

價格可為數字,後方加上以英文字母構成的貨幣代碼 (需符合 ISO 4217 標準);請使用「.」做為小數點符號,例如 $20,000.00 美元。

salePrice

string

售價,可為數字,後方加上以英文字母構成的貨幣代碼 (需符合 ISO 4217 標準);請使用「.」做為小數點符號,例如 15,000.00 美元。必須小於「price」欄位。

formattedPrice

string

格式化的價格,可使用任何字元。如果已設定,系統會使用這項屬性,而非「price」,例如「Starting at $20,000.00」。

formattedSalePrice

string

格式化特價,可包含任何字元。如果設定了這項屬性,系統會使用這項屬性取代「特價」,例如「特價 $15,000.00」。

imageUrl

string

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

contextualKeywords[]

string

內容比對關鍵字,例如 Sedans、4 door sedans。

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。必須小於「price」欄位。

starRating

string (int64 format)

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

category

string

類別,例如飯店套房。

contextualKeywords[]

string

內容比對關鍵字,例如 Mountain View "Hotels"、South Bay hotels。

address

string

地址可使用下列任一格式指定。(1) 城市、州/省、代碼、國家/地區,例如美國加州山景城。(2) 完整地址,例如 123 Boulevard St, Mountain View, CA 94043。(3) 經緯度 (格式為 DDD),例如 41.40338, 2.17403

iosAppStoreId

string (int64 format)

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

formattedPrice

string

格式化的價格,可使用任何字元。如果已設定,系統會使用這項屬性而非「price」,例如「Starting at $100.00」。

formattedSalePrice

string

格式化特價,可包含任何字元。如果設定了這項屬性,系統會使用這項屬性取代「特價」,例如「特價 $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

必要欄位。目的地 ID 可以是任何英文字母和數字組合,且不得重複,且必須與再行銷標記的值一致。必填。

originId

string

來源 ID,可由任意順序的字母和數字組成。ID 序列 (destination ID + origin 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」,例如「Starting at $100.00」。

formattedSalePrice

string

格式化特價,可包含任何字元。如果設定了這項屬性,系統會使用這項屬性取代「特價」,例如「特價 $80.00」。

iosAppStoreId

string (int64 format)

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

similarDestinationIds[]

string

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

customMapping

string

自訂欄位可包含多個鍵/值對應,並以分隔符號 (「,」, 「|」和「:」) 分隔,格式為「: , , ... , | : , ... , | ... | : , ... ,」(例如「wifi: most | aircraft: 320, 77W | flights: 42 | legroom: 32」)。

DemandGenCarouselCardAsset

需求開發輪轉介面資訊卡素材資源。

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

必要欄位。目的地 ID 可以是任何英文字母和數字組合,且不得重複,且必須與再行銷標記的值一致。必填。

originId

string

來源 ID,可由任意順序的字母和數字組成。ID 序列 (destination ID + origin ID) 不得重複。

title

string

必要欄位。標題,例如「預訂火車票」。必填。

destinationName

string

目的地名稱,例如巴黎。

destinationAddress

string

可使用下列任一格式指定的目的地址。(1) 城市、州/省、代碼、國家/地區,例如美國加州山景城。(2) 完整地址,例如 123 Boulevard St, Mountain View, CA 94043。(3) 經緯度 (格式為 DDD),例如 41.40338, 2.17403。

originName

string

起點名稱,例如倫敦。

price

string

價格可以是數字,後方加上以英文字母構成的貨幣代碼 (需符合 ISO 4217 標準);請使用「.」做為小數點符號,例如 $100.00 美元。

salePrice

string

售價,可為數字,後方加上以英文字母構成的貨幣代碼 (需符合 ISO 4217 標準);請使用「.」做為小數點符號,例如 80.00 USD。必須小於「price」欄位。

formattedPrice

string

格式化的價格,可使用任何字元。如果已設定,系統會使用這項屬性而非「price」,例如「Starting at $100.00」。

formattedSalePrice

string

格式化特價,可包含任何字元。如果設定了這項屬性,系統會使用這項屬性取代「特價」,例如「特價 $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

必要欄位。優惠名稱,例如「Mountain View Grocers 8 折」必填。

subtitle

string

副標題,例如「雜貨」。

description

string

說明,例如「節省每週帳單費用」。

price

string

價格可以是數字,後方加上以英文字母構成的貨幣代碼 (需符合 ISO 4217 標準);請使用「.」做為小數點符號,例如 $100.00 美元。

salePrice

string

售價,可為數字,後方加上以英文字母構成的貨幣代碼 (需符合 ISO 4217 標準);請使用「.」做為小數點符號,例如 80.00 USD。必須小於「price」欄位。

imageUrl

string

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

address

string

地址可使用下列任一格式指定。(1) 城市、州/省、代碼、國家/地區,例如美國加州山景城。(2) 完整地址,例如 123 Boulevard St, Mountain View, CA 94043。(3) 經緯度 (格式為 DDD),例如 41.40338, 2.17403。

category

string

類別,例如「美食」。

contextualKeywords[]

string

內容比對關鍵字,例如 Save groceries coupons。

formattedPrice

string

格式化的價格,可使用任何字元。如果已設定,系統會使用這項屬性而非「price」,例如「Starting at $100.00」。

formattedSalePrice

string

格式化特價,可包含任何字元。如果設定了這項屬性,系統會使用這項屬性取代「特價」,例如「特價 $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

說明,例如:Apply your technical skills。

imageUrl

string

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

jobCategory

string

工作類別,例如技術。

contextualKeywords[]

string

內容比對關鍵字,例如軟體工程師職缺。

address

string

地址可使用下列任一格式指定。(1) 城市、州/省、代碼、國家/地區,例如美國加州山景城。(2) 完整地址,例如 123 Boulevard St, Mountain View, CA 94043。(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,就會以地點額外資訊的形式放送。如果類型為 AFFILIATE,則會做為聯盟位置放送。

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

飯店名稱。唯讀。

BusinessMessageAsset

消費者訊息素材資源。

JSON 表示法
{
  "messageProvider": enum (BusinessMessageProvider),
  "starterMessage": string,
  "callToAction": {
    object (BusinessMessageCallToActionInfo)
  },

  // Union field message_provider_data can be only one of the following:
  "whatsappInfo": {
    object (WhatsappBusinessMessageInfo)
  }
  // End of list of possible types for union field message_provider_data.
}
欄位
messageProvider

enum (BusinessMessageProvider)

必要欄位。消費者訊息素材資源的訊息供應者。

starterMessage

string

必要欄位。歡迎訊息,提示使用者發起對話。

callToAction

object (BusinessMessageCallToActionInfo)

消費者訊息素材資源的行動號召。

聯集欄位 message_provider_data。用於傳送訊息的訊息供應商資訊。message_provider_data 只能是下列其中一項:
whatsappInfo

object (WhatsappBusinessMessageInfo)

WhatsApp。

BusinessMessageProvider

商家訊息供應者類型的可能值。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中未知的值。
WHATSAPP WhatsApp 訊息供應端

BusinessMessageCallToActionInfo

顯示鼓勵使用者採取行動的資訊。

JSON 表示法
{
  "callToActionSelection": enum (BusinessMessageCallToActionType),
  "callToActionDescription": string
}
欄位
callToActionSelection

enum (BusinessMessageCallToActionType)

必要欄位。預先定義的行動號召文字。

callToActionDescription

string

必要欄位。文字提供明確的價值主張,說明使用者採取行動後可獲得的預期效益。例如:「請傳送訊息給我們,以便提供報價」或「請諮詢我們的專家團隊」。

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

string

必要欄位。電話號碼的國家/地區代碼 (由兩個英文字母組成)。例如:'US'、'us'。

phoneNumber

string

必要欄位。商家的 WhatsApp 電話號碼。範例:「1234567890」、「(123)456-7890」。

AppDeepLinkAsset

應用程式深層連結素材資源

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