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)
  }
  // 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。定义此表单字段接受的答案配置。如果未设置 oneof，则为自由文本答案。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

确切的自定义问题字段文本（例如“您的车辆属于哪种类型？”）。
联合字段 answers。定义此表单字段接受的答案配置。如果未设置 oneof，则为自由文本答案。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)

网络钩子传送方法。

WebhookDelivery

Google 会向广告客户指定的端点发出 HTTP 调用，从而将潜在客户信息告知他们。这些请求包含的 JSON 与 Google 作为表单广告文档的一部分发布的架构相匹配。

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 个字符之间（含 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) 城市、州/省/自治区/直辖市、代码、国家/地区，例如美国加利福尼亚州山景城。(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，如 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 之间（含 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) 城市、州/省/自治区/直辖市、代码、国家/地区，例如美国加利福尼亚州山景城。(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，可以是任意字母和数字序列，且必须是唯一的，并且与再营销代码的值（例如“轿车”）相匹配。必填。
id2

string

ID2，可以是任意字母和数字序列，例如红色。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

统一格式的促销价，可以是任何字符。如果已设置，系统会使用此属性而非 '促销价' [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

必需。房源名称（例如“朝阳酒店”）。必填。
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) 城市、州/省/自治区/直辖市、代码、国家/地区，例如美国加利福尼亚州山景城。(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

一个自定义字段，可以是映射至分隔符（“,”“|”和“:”）的多个键到值，格式为“: , , ... , | : , ... , | ... | : , ... ,”。例如，wifi：大多数 | 飞机：320 | 77 W | 航班：320}42 |

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”[价格]，例如，起价 $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) 城市、州/省/自治区/直辖市、代码、国家/地区，例如美国加利福尼亚州山景城。(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) 城市、州/省/自治区/直辖市、代码、国家/地区，例如美国加利福尼亚州山景城。(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

酒店的名称。只读。