Asset

素材资源是广告的组成部分，可以在多个广告之间共享。可以是图片 (ImageAsset)、视频 (YoutubeVideoAsset) 等。素材资源不可更改，不能移除。如需停止投放某个素材资源，请从使用该素材资源的实体中移除该素材资源。

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

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

string

不可变。资产的资源名称。资源资源名称采用以下格式：

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

enum (AssetType)

仅供输出。资产的类型。
finalUrls[]

string

经过所有跨网域重定向后可能出现的最终到达网址的列表。
finalMobileUrls[]

string

包含所有跨网域重定向后可能的最终到达移动网址的列表。
urlCustomParameters[]

object (CustomParameter)

映射列表，用于替换 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)

不可变。酒店房源素材资源。

AssetType

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

枚举
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 酒店房源素材资源。

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 的广告字段的文档。此字段只进行了 mutate 操作。

使用 base64 编码的字符串。

ImageAsset

图片素材资源。

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

enum (MimeType)

图片资源的 MIME 类型。
fullSize

object (ImageDimension)

此图片以原始大小显示的元数据。
data

string (bytes format)

图片的原始字节数据。此字段只进行了 mutate 操作。

使用 base64 编码的字符串。
fileSize

string (int64 format)

图片资源的文件大小（以字节为单位）。

ImageDimension

特定尺寸的图片的元数据，可以是原始图片，也可以是调整大小后的图片。

JSON 表示法 
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
字段
heightPixels

string (int64 format)

图片的高度。
widthPixels

string (int64 format)

图片的宽度。
url

string

可返回具有指定高度和宽度的图片的网址。

TextAsset

文字素材资源。

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

string

文字素材资源的文字内容。

LeadFormAsset

潜在客户表单素材资源。

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

string

必需。所宣传企业的名称。
callToActionType

enum (LeadFormCallToActionType)

必需。鼓励用户展开表单的预定义显示文本。
callToActionDescription

string

必需。用于明确价值主张的文字，让用户在展开表单后会获得怎样的体验。
headline

string

必需。展开的表单的标题，用于描述表单请求或协助提供的内容。
description

string

必需。展开表单的详细说明，以说明表单要求或协助提供的内容。
privacyPolicyUrl

string

必需。指向有关广告客户/商家如何处理所收集数据的政策的页面的链接。
fields[]

object (LeadFormField)

有序的输入字段列表。可通过对问题重新排序来更新此字段，但不能通过添加或移除问题来更新此字段。
customQuestionFields[]

object (LeadFormCustomQuestionField)

自定义问题字段的有序列表。此字段最多只能包含 5 个甄别问题。
deliveryMethods[]

object (LeadFormDeliveryMethod)

已配置的方法，将收集的潜在客户数据传送给广告客户。只能配置一个类型为 WebhookDelivery 的方法。
postSubmitCallToActionType

enum (LeadFormPostSubmitCallToActionType)

鼓励用户在提交表单后操作的预定义显示文本。
desiredIntent

enum (LeadFormDesiredIntent)

为潜在客户表单选择了意向，例如“更多”或“更符合条件”。
postSubmitHeadline

string

提交表单后显示的文字标题，用于说明广告主将如何跟进用户。
postSubmitDescription

string

表单提交后显示的详细说明，用于说明广告主将如何与用户取得联系。
backgroundImageAsset

string

背景图片的资源资源名称。图片尺寸必须为 1200x628。
customDisclosure

string

在潜在客户表单上与 Google 免责声明一起显示自定义披露信息。仅限获得许可的客户访问。

LeadFormCallToActionType

描述潜在客户表单中号召性用语类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中的未知值。
LEARN_MORE 了解详情。
GET_QUOTE 获取报价。
APPLY_NOW 立即申请。
SIGN_UP 注册。
CONTACT_US 与我们联系。
SUBSCRIBE 订阅。
DOWNLOAD 下载。
BOOK_NOW 立即预订。
GET_OFFER 领取优惠。
REGISTER 注册。
GET_INFO 获取信息。
REQUEST_DEMO 申请演示。
JOIN_NOW 立即加入。
GET_STARTED 开始使用

LeadFormField

表单中的一个输入字段实例。

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

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

enum (LeadFormFieldUserInputType)

描述输入类型，可以是预定义的类型（如“全名”）或经过预先审查的问题（如“您拥有哪种车辆？”）。
联合字段 answers。定义此表单字段接受的答案配置。如果未设置其中任何一项，则为自由文本答案。answers 只能是下列其中一项：
singleChoiceAnswers

object (LeadFormSingleChoiceAnswers)

单选题的答案配置。只能为预先审查的问题字段设置此字段。至少需要 2 个答案，最多 12 个。
hasLocationAnswer

boolean

位置问题的回答配置。如果为 true，广告系列/帐号一级的位置数据（州、城市、商家名称等）将在潜在客户表单中呈现。从 V13.1 开始，对于在广告系列/账号一级设置了地址素材资源的广告客户，只能针对“您的首选经销商是哪里？”问题设置 hasLocationAnswer。

LeadFormSingleChoiceAnswers

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

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

string

单个问题字段的选项列表。条目的顺序定义了界面顺序。至少需要 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

确切的自定义问题字段文本（例如“What kind of vehicle do you have?”）。
联合字段 answers。定义此表单字段接受的答案配置。如果未设置其中任何一项，则为自由文本答案。answers 只能是下列其中一项：
singleChoiceAnswers

object (LeadFormSingleChoiceAnswers)

单选题的答案配置。回答最少 2 个，最多 12 个。
hasLocationAnswer

boolean

位置问题的回答配置。如果为 true，广告系列/帐号一级的位置数据（州、城市、商家名称等）将在潜在客户表单中呈现。从 V13.1 开始，对于在广告系列/账号一级设置了地址素材资源的广告客户，只能针对“您的首选经销商是哪里？”问题设置 hasLocationAnswer。

LeadFormDeliveryMethod

配置如何向广告客户提供潜在客户信息。

JSON 表示法 
{

  // Union field delivery_details can be only one of the following:
  "webhook": {
    object (WebhookDelivery)
  }
  // End of list of possible types for union field delivery_details.
}
字段
联合字段 delivery_details。投放的各种子类型。delivery_details 只能是下列其中一项：
webhook

object (WebhookDelivery)

Webhook 传送方法。

WebhookDelivery

Google 通过向广告主指定的端点发出 HTTP 调用来通知广告主存在潜在客户信息。这些请求包含与 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)

用户要想享受促销，订单总金额必须达到这一金额。

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

学校名称，例如北京朝阳护理学校。
address

string

学校地址，可以采用以下某种格式指定。(1) 城市、州/省/自治区/直辖市、代码、国家/地区，例如 Mountain View, CA, USA。(2) 完整地址，例如：123 Boulevard St, Mountain View, CA 94043。(3) 采用 DDD 格式的经纬度，例如：41.40338, 2.17403
contextualKeywords[]

string

内容相关关键字，例如“护理认证”、“健康”、“山景城”。
similarProgramIds[]

string

类似计划 ID。
iosAppStoreId

string (int64 format)

iOS App Store ID。系统会先使用此属性来检查用户是否已在其设备上安装应用，然后再通过深层链接将用户转到着陆页。如果设置了此字段，还必须提供 iosAppLink 字段。
thumbnailImageUrl

string

缩略图网址，例如 http://www.example.com/thumbnail.png。缩略图图片不会作为图片素材资源上传。
imageUrl

string

图片网址，例如 http://www.example.com/image.png。不会以图片素材资源的形式上传此图片。

MobileAppAsset

代表移动应用的素材资源。

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

string

必需。一个唯一标识移动应用的字符串。它应该只包含平台原生 ID，例如“com.android.ebay”（对于 Android）或“12345689”（对于 iOS）。
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 之间（含 3 和 8）。

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

包含所有跨网域重定向后的最终到达移动网址。

CallToActionAsset

号召性用语素材资源。

JSON 表示法 
{
  "callToAction": enum (CallToActionType)
}
字段
callToAction

enum (CallToActionType)

号召性用语。

DynamicRealEstateAsset

动态房地产素材资源。

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

string

必需。房源 ID，可以是字母和数字的任意序列，必须是唯一的，并且与再营销标记的值匹配。必填。
listingName

string

必需。房源名称，例如 Boulevard Bungalow。必填。
cityName

string

城市名称，例如“北京朝阳区”。
description

string

例如，3 床 2 卫，1568 平方英尺
address

string

地址，可以采用以下格式之一进行指定。(1) 城市、州/省/自治区/直辖市、代码、国家/地区，例如 Mountain View, CA, USA。(2) 完整地址，例如：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，可以是字母和数字的任意序列，例如红色。ID 序列 (ID + ID2) 必须是唯一的。
itemTitle

string

必需。商品标题，例如中型轿车。必填。
itemSubtitle

string

商品副标题，例如“在山景城经销商处”。
itemDescription

string

商品描述，例如畅销中型汽车。
itemAddress

string

可以采用以下某种格式指定的商品地址。(1) 城市、州/省/自治区/直辖市、代码、国家/地区，例如 Mountain View, CA, USA。(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

统一格式的促销价，可以是任意字符。如果设置了此属性，系统将使用此属性而非“sale price”[促销价] 来实现“促销价”属性，例如“促销价为 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

目的地名称，例如“Downtown Mountain View”。
description

string

说明，例如“靠近 SJC 机场”。
price

string

价格，可以是数字后跟字母货币代码，遵循 ISO 4217 标准。使用“.”作为小数点，例如 100.00 USD。
salePrice

string

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

string (int64 format)

星级。必须是 1 到 5 之间的数字（含 1 和 5）。
category

string

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

string

内容相关关键字，例如山景城“酒店”，南湾酒店。
address

string

地址，可以采用以下格式之一进行指定。(1) 城市、州/省/自治区/直辖市、代码、国家/地区，例如 Mountain View, CA, USA。(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”。例如，“$100.00 起”。
formattedSalePrice

string

统一格式的促销价，可以是任意字符。如果设置，系统将使用此属性而非 '促销价' [sale price] 属性，例如“促销价为 80.00 美元”。
similarPropertyIds[]

string

类似房源 ID。

DynamicFlightsAsset

动态航班素材资源。

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

string

必需。目标页面 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”。例如，“$100.00 起”。
formattedSalePrice

string

统一格式的促销价，可以是任意字符。如果设置，系统将使用此属性而非 '促销价' [sale price] 属性，例如“促销价为 80.00 美元”。
iosAppStoreId

string (int64 format)

iOS App Store ID。系统会先使用此属性来检查用户是否已在其设备上安装应用，然后再通过深层链接将用户转到着陆页。如果设置了此字段，还必须提供 iosAppLink 字段。
similarDestinationIds[]

string

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

string

自定义字段可以是以分隔符（“: , , ... , | : , ... , | ... | : , ... ,）分隔的多个键到值，使用分隔符（“: , , ... , | : , ... , | ... | : , ... ,”）进行映射

DiscoveryCarouselCardAsset

一项轮播式发现广告卡片素材资源。

JSON 表示法 
{
  "marketingImageAsset": string,
  "squareMarketingImageAsset": string,
  "portraitMarketingImageAsset": string,
  "headline": string,
  "callToActionText": string
}
字段
marketingImageAsset

string

相关 1.91:1 营销图片的素材资源资源名称。必须提供此和/或方形营销图片素材资源。
squareMarketingImageAsset

string

相关方形营销图片的素材资源资源名称。此素材资源和/或营销图片素材资源为必填项。
portraitMarketingImageAsset

string

关联的 4:5 纵向营销图片的素材资源资源名称。
headline

string

必需。轮播卡片的标题。
callToActionText

string

号召性用语文字。

DynamicTravelAsset

动态旅游素材资源。

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

string

必需。目标页面 ID，可以是字母和数字的任意序列，必须是唯一的，并且与再营销代码的值匹配。必填。
originId

string

出发地 ID，可以是字母和数字的任意序列。ID 序列（目的地 ID + 出发地 ID）必须是唯一的。
title

string

必需。标题，例如“预订火车票”。必填。
destinationName

string

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

string

目的地地址，可以采用以下格式之一进行指定。(1) 城市、州/省/自治区/直辖市、代码、国家/地区，例如 Mountain View, CA, USA。(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”。例如，“$100.00 起”。
formattedSalePrice

string

统一格式的促销价，可以是任意字符。如果设置，系统将使用此属性而非 '促销价' [sale price] 属性，例如“促销价为 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) 城市、州/省/自治区/直辖市、代码、国家/地区，例如 Mountain View, CA, USA。(2) 完整地址，例如：123 Boulevard St, Mountain View, CA 94043。(3) 采用 DDD 格式的经纬度，例如 41.40338, 2.17403。
category

string

类别，例如食品。
contextualKeywords[]

string

内容相关关键字，例如“保存杂货优惠券”。
formattedPrice

string

统一格式的价格，可以是任意字符。如果设置此属性，则使用此属性来替代“price”。例如，“$100.00 起”。
formattedSalePrice

string

统一格式的促销价，可以是任意字符。如果设置，系统将使用此属性而非 '促销价' [sale price] 属性，例如“促销价为 80.00 美元”。
similarDealIds[]

string

类似交易 ID，例如 1275。
iosAppStoreId

string (int64 format)

iOS App Store ID。系统会先使用此属性来检查用户是否已在其设备上安装应用，然后再通过深层链接将用户转到着陆页。如果设置了此字段，还必须提供 iosAppLink 字段。

DynamicJobsAsset

动态招聘信息素材资源。

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

string

必需。职位 ID，可以是字母和数字的任意序列，必须是唯一的，并且与再营销代码的值匹配。必填。
locationId

string

地理位置 ID，可以是任意字母和数字序列。ID 序列（作业 ID + 地理位置 ID）必须是唯一的。
jobTitle

string

必需。职位，例如软件工程师。必填。
jobSubtitle

string

职位副标题，例如 II 级。
description

string

例如“运用您的技术技能”。
imageUrl

string

图片网址，例如 http://www.example.com/image.png。不会以图片素材资源的形式上传此图片。
jobCategory

string

职位类别，例如“技术”。
contextualKeywords[]

string

内容相关关键字，例如“软件工程职位”。
address

string

地址，可以采用以下格式之一进行指定。(1) 城市、州/省/自治区/直辖市、代码、国家/地区，例如 Mountain View, CA, USA。(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 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

酒店的名称。只读。