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)

页面 Feed 素材资源。
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)

商家消息素材资源。

资源类型

用于描述可能的资产类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
YOUTUBE_VIDEO YouTube 视频素材资源。
MEDIA_BUNDLE 媒体包素材资源。
IMAGE 图片素材资源。
TEXT 文字素材资源。
LEAD_FORM 潜在客户表单素材资源。
BOOK_ON_GOOGLE “通过 Google 预订”素材资源。
PROMOTION 促销信息素材资源。
CALLOUT 宣传信息素材资源。
STRUCTURED_SNIPPET 结构化摘要素材资源。
PAGE_FEED 页面 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 开始，对于在广告系列/账号一级设置了地址素材资源的广告客户，只有“您的首选经销商是哪家？”问题才可以设置 hasLocationAnswer。

LeadFormSingleChoiceAnswers

定义单选题的可能答案，通常以单选下拉列表的形式显示。

JSON 表示法 
{
  "answers": [
    string
  ]
}
字段
answers[]

string

单个题目字段的选项列表。条目的顺序定义了界面顺序。答案必须至少有 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 开始，对于在广告系列/账号一级设置了地址素材资源的广告客户，只有“您的首选经销商是哪家？”问题才可以设置 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)

通过网络钩子发送。

WebhookDelivery

Google 会向广告客户指定的端点发出 HTTP 调用，以便告知广告客户有潜在客户。这些请求包含与 Google 在表单广告文档中发布的架构匹配的 JSON。

JSON 表示法 
{
  "advertiserWebhookUrl": string,
  "googleSecret": string,
  "payloadSchemaVersion": string
}
字段
advertiserWebhookUrl

string

广告客户指定的用于发送潜在客户的网络钩子网址。
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 网购星期一。
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

由 3 个字符组成的 ISO 4217 货币代码。
amountMicros

string (int64 format)

金额以微单位表示。一百万个微单位为一个单位。

CalloutAsset

宣传信息素材资源。

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

string

必需。宣传信息文字。此字符串的长度应介于 1 和 25 之间（含 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 之间（包括 3 和 10）。每个值的长度应介于 1 到 25 个字符之间（包括这两个数值）。

SitelinkAsset

站内链接素材资源。

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

string

必需。站内链接的网址显示文本。此字符串的长度应介于 1 和 25 之间（含 1 和 25）。
description1

string

站内链接的说明的第一行。如此行已设置，则长度应介于 1 到 35 之间（包括 1 和 35），并且还必须设置 description2。
description2

string

站内链接的说明的第二行。如此行已设置，则长度应介于 1 到 35 之间（包括 1 和 35），并且还必须设置 description1。
startDate

string

此素材资源生效并可开始投放的开始日期（采用 yyyy-MM-dd 格式）。
endDate

string

此素材资源有效且仍在投放的最后一天，格式为 yyyy-MM-dd。
adScheduleTargets[]

object (AdScheduleInfo)

非重叠时间表列表，用于指定素材资源可以投放的所有时间间隔。每天最多可设置 6 个投放时间，总计 42 个。

PageFeedAsset

页面 Feed 素材资源。

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

必需。计划 ID，可以是字母和数字的任意序列，必须是唯一的，且与再营销代码的值相符。必填。
locationId

string

营业地点 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

内容相关关键字，例如护理认证、健康、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)

必需。分发此特定应用的应用商店。
linkText

string

必需。在广告中呈现链接时显示的可见文本。此字符串的长度应介于 1 和 25 之间（含 1 和 25）。
startDate

string

此素材资源生效并可开始投放的开始日期（采用 yyyy-MM-dd 格式）。
endDate

string

此素材资源有效且仍在投放的最后一天，格式为 yyyy-MM-dd。

HotelCalloutAsset

表示酒店宣传信息的素材资源。

JSON 表示法 
{
  "text": string,
  "languageCode": string
}
字段
text

string

必需。酒店宣传信息素材资源的文字。此字符串的长度应介于 1 和 25 之间（含 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 之间（含 1 和 25）。
description

string

必需。价格优惠的说明。此字符串的长度应介于 1 和 25 之间（含 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

说明，例如，三室两卫 120 平
address

string

地址，可以采用以下任一格式指定。(1) 城市、州/省/直辖市/自治区、代码、国家/地区，例如美国加利福尼亚州山景城。(2) 完整地址，例如 123 Boulevard St, Mountain View, CA 94043。(3) 经纬度（采用 DDD 格式），例如 41.40338, 2.17403
price

string

价格，可以是数字后跟采用 ISO 4217 标准的字母币种代码。使用“.”作为小数点，例如 200,000.00 USD。
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，可以是任意顺序的字母和数字，例如 red。ID 序列（ID + ID2）必须具有唯一性。
itemTitle

string

必需。商品名，例如“中型轿车”。必填。
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 USD。
salePrice

string

促销价，可以是数字后跟采用 ISO 4217 标准的字母币种代码。使用“.”作为小数点，例如 15,000.00 USD。必须小于“price”字段。
formattedPrice

string

格式化价格，可以是任何字符。如果设置此属性，系统会使用此属性而非“price”（价格），例如“20,000.00 美元起”。
formattedSalePrice

string

采用统一格式的促销价，可以包含任何字符。如果设置了此属性，系统会使用此属性而非“促销价”，例如“促销价：15,000.00 美元”。
imageUrl

string

图片网址，例如 http://www.example.com/image.png。系统不会将图片作为图片素材资源上传。
contextualKeywords[]

string

内容相关关键字，例如“轿车”“四门轿车”。
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 USD。
salePrice

string

ISO 4217 标准。使用“.”作为小数点，例如 80.00 USD。必须小于“price”字段。
starRating

string (int64 format)

星级。必须介于 1 到 5 之间（包括这两个数值）。
category

string

类别，例如酒店套房。
contextualKeywords[]

string

内容相关关键字，例如“朝阳 "酒店"、地铁口酒店。
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”（价格从 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 序列（目标 ID + 来源 ID）必须具有唯一性。
flightDescription

string

必需。航班说明，例如“预订机票”。必填。
imageUrl

string

图片网址，例如 http://www.example.com/image.png。系统不会将图片作为图片素材资源上传。
destinationName

string

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

string

出发地名称，例如伦敦。
flightPrice

string

航班价格，可以是数字后跟采用 ISO 4217 标准的字母币种代码。使用“.”作为小数点，例如 100.00 USD。
flightSalePrice

string

机票促销价，可以是数字后跟采用 ISO 4217 标准的字母币种代码。使用“.”作为小数点，例如 80.00 USD。必须小于“flightPrice”字段。
formattedPrice

string

格式化价格，可以是任何字符。如果设置此属性，系统会使用此属性而非“price”（价格），例如“Starting at $100.00”（价格从 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 序列（目标 ID + 来源 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 USD。
salePrice

string

促销价，可以是数字后跟采用 ISO 4217 标准的字母币种代码。使用“.”作为小数点，例如 80.00 USD。必须小于“price”字段。
formattedPrice

string

格式化价格，可以是任何字符。如果设置此属性，系统会使用此属性而非“price”（价格），例如“Starting at $100.00”（价格从 100.00 美元起）。
formattedSalePrice

string

采用统一格式的促销价，可以包含任何字符。如果设置，系统会使用此属性而非“促销价”，例如“促销价：80.00 美元”。
category

string

类别，例如“速成”。
contextualKeywords[]

string

内容相关关键字，例如“巴黎火车”。
similarDestinationIds[]

string

类似目的地 ID，例如纽约市。
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

必需。特惠名称，例如“朝阳百货全场五折”。必填。
subtitle

string

副标题，例如“杂货”。
description

string

说明，例如“全市最低价，不容错过”。
price

string

价格，可以是数字后跟采用 ISO 4217 标准的字母币种代码。使用“.”作为小数点，例如 100.00 USD。
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

内容相关关键字，例如“省钱百货优惠券”。
formattedPrice

string

格式化价格，可以是任何字符。如果设置此属性，系统会使用此属性而非“price”（价格），例如“Starting at $100.00”（价格从 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

工作副标题，例如“第 II 级”。
description

string

说明，例如“保证人尽其才”。
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

薪水，例如 10 万美元。
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 Places 数据库中和 Google 地图上的地点。对于给定的客户 ID 和素材资源类型，此字段是唯一的。如需详细了解地点 ID，请访问 https://developers.google.com/places/web-service/place-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 Places 数据库中和 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
}
字段