资产组记录 - 批量
定义可在批量文件中下载和上传的资产组。
通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 AssetGroups 的 DownloadEntity 值，可以下载帐户中的所有资产组记录。 此外，下载请求必须包括 EntityData 范围。 有关批量服务的更多详细信息（包括最佳做法），请参阅 批量下载和上传。
如果使用用于 .NET、Java 或 Python 的必应广告 SDK ，则可以使用 BulkServiceManager 来节省时间来上传和下载 BulkAssetGroup 对象，而无需直接调用服务操作和编写自定义代码来分析批量文件中的每个字段。
对于 资产组 记录， 批量文件架构中提供了以下属性字段。
- 资产组
- 企业名称
- 行动号召
- 市场活动
- 客户端 ID
- 说明
- 编辑上诉状态
- 编辑位置
- 编辑原因代码
- 编辑状态
- 编辑术语
- "结束日期"
- 最终 URL
- 标题
- Id
- Images
- 长标题
- 移动最终 URL
- 修改时间
- 父 ID
- 路径 1
- 路径 2
- 状态
- "开始日期"
资产组
资产组的名称。
添加： 必填
更新： 选。 如果未为更新设置任何值，则不会更改此设置。
删除： 只读和必需
企业名称
企业名称。
根据受众广告的放置情况，你的企业名称可能会显示在广告中。
字符串的长度限制为 25 个字符。
添加： 必填
更新： 选。 如果未为更新设置任何值，则不会更改此设置。
删除： 只读
行动号召
客户立即点击广告的简短而有力的理由。
可能的值包括 ActNow、AddToCart、ApplyNow、Automate、BetNow、BidNow、BookACar、BookHotel、BookNow、BookTravel、Browse、BuildNow、Buy、BuyNow、ChatNow、Compare、ContactUs、优惠券、经销商、Default、 Directions、Donate、Download、EmailNow、EnrollNow、Explore、FileNow、FindJob、FindStore、FreePlay、FreeQuote、FreeTrial、GetDeals、GetDemo、GetNow、GetOffer、GetQuote、GoToDemo、Install、JoinNow、LearnMore、ListenNow、LogIn、Message、NewCars、NoButton、OpenLink、OrderNow、PlayGame、PlayNow、 PostJob、Register、RegisterNow、RenewNow、RentACar、RentNow、Reorder、Reserve、Sale、SaveNow Schedule、SeeDemo、SeeMenu、SeeModels、SeeMore、SeeOffer、SeeOffers、SellNow、ShopNow、Showtimes、SignIn、SignUp、StartFree、StartNow、Subscribe、SwitchNow、TestDrive、TryNow、Unknown、UsedCars、ViewCars、ViewDemo、ViewNow、ViewPlans、VisitSite、VisitStore、VoteNow、Watch、WatchMore、WatchNow。
添加： 必填。
更新： 选。 如果未为更新设置任何值，则不会更改此设置。
删除： 只读
Campaign
包含资产组的市场活动的名称。
添加： 只读和必需
更新： 只读和必需
删除： 只读和必需
客户端 ID
用于将批量上传文件中的记录与结果文件中的记录相关联。 服务器不使用或存储此字段的值;它只是从上传的记录复制到相应的结果记录。 它可以是长度最大为 100 的任何有效字符串。
添加： 选
更新： 选。 如果未为更新设置任何值，则不会更改此设置。 若要删除所有自定义参数，请将此字段设置为 delete_value。
delete_value关键字 (keyword) 删除以前的设置。 若要删除自定义参数的子集，请指定要保留的自定义参数，并省略任何不想保留的参数。 新的自定义参数集将替换以前的任何自定义参数集。
删除： 只读
说明
必应可用于优化广告布局的说明列表。
为了在所有广告格式中最大化展示，广告中可能不会始终显示说明。
从数据模型的角度来看，说明存储为文本资产。 同一资产可由多个广告使用。 例如，如果“无缝集成”是文本资产，它将在同一 Microsoft Advertising 帐户中的所有广告中具有相同的资产标识符。
必须在 2-5 个说明之间设置。 说明在大容量文件中以 JSON 字符串的形式表示。 以下示例 JSON 中包含两个说明，第一个说明固定到特定位置。
id和 text 是资产的属性，而 editorialStatus 和 assetPerformanceLabel 是资产链接的属性，即资产与广告之间的关系。 有关详细信息，请参阅下面的 assetPerformanceLabel、 editorialStatus、 id 和 文本 。
[{
"text": "Find New Customers & Increase Sales!",
},
{
"text": "Start Advertising on Contoso Today."
}]
注意
在逗号分隔的大容量文件中，需要用一组额外的双引号将资产链接、每个属性键和每个属性字符串值括起来，例如，上面的 JSON 字符串将写为 “[{”text“”：“查找新客户 & 增加销售额！”}，{“text”：“”开始在 Contoso Today 上播发广告“。”}”。
下面是批量下载示例，其中还将获取只读属性，例如 id 和 editorialStatus：
[{
"id": 1,
"text": "Contoso",
"editorialStatus": "Active",
"assetPerformanceLabel": "Learning"
},
{
"id": 2,
"text": "Seamless Integration",
"editorialStatus": "Active",
"assetPerformanceLabel": "Learning"
}]
添加： 如果父市场活动未关联到商店，则是必需的;如果父市场活动关联到商店，则为可选。 如果父市场活动关联到某个商店，并且你指定了“说明”，则还必须指定“标题”、“长标题”和“图像”。 仅遵循 文本 。 即使帐户中已存在资产，如果包含 ID、assetPerformanceLabel 和 editorialStatus，也会忽略它们。
更新： 选。 若要保留所有现有资产链接，请将此字段设置为空或留空。 如果设置此字段，将替换以前链接到此广告的任何说明。 如果指定此字段，则需要包含 2-5 个说明的列表。 仅遵循 文本 。 即使帐户中已存在资产，如果包含 ID、assetPerformanceLabel 和 editorialStatus，也会忽略它们。
删除： 只读
assetPerformanceLabel
这可让你了解资产的性能。
下载 assetPerformanceLabel 响应式搜索广告时，属性是只读的。 下表介绍了可能的值。
| 值 | 说明 |
|---|---|
| 低 | 此资产的性能较低，建议替换此资产以提高广告性能。 |
| Good | 此资产性能良好。 建议保留此资产并添加更多资产以提高广告性能。 |
| 最好 | 此资产的性能是最好的，建议添加更多类似的资产。 |
| 未分级 | 对此资产没有任何性能评级。 这可能是由于资产处于非活动状态，没有足够的信息来确定其性能，或者没有足够的类似资产与之进行比较。 |
| 学习 | 正在积极评估资产的性能。 评估完成后，资产评级将为“低”、“良好”、“最佳”或“未评级”。 |
editorialStatus
下载 editorialStatus 响应式搜索广告时，属性是只读的。 下表介绍了可能的值。
| 值 | 说明 |
|---|---|
| 活动 | 资产通过了编辑评审。 |
| ActiveLimited | 资产在一个或多个市场通过了编辑评审，资产的一个或多个元素正在另一个市场进行编辑评审。 例如，资产通过了加拿大的编辑评审，并且仍在美国中等待评审。 |
| 反对 | 资产编辑评审失败。 |
| 非活动 | 资产的一个或多个元素正在接受编辑评审。 |
| 未知 | 保留供以后使用。 |
id
属性 id 是 Microsoft Advertising 帐户中资产的唯一 Microsoft Advertising 标识符。
同一资产可由多个广告使用。 例如，如果“无缝集成”是文本资产，它将在同一 Microsoft Advertising 帐户中的所有广告中具有相同的资产标识符。 上传文本资产后，结果文件将包括资产标识符，例如 ""id:""123，无论资产是新资产还是已存在于帐户的资产库中。
text
每个说明的属性 text 必须至少包含一个单词。 每个说明 text 属性的最大输入长度为 90 个字符。 对于具有双角字符的语言（例如繁体中文），最大输入长度为 45 个字符。 双角字符由你使用的字符而不是市场活动或广告组语言设置的字符集决定。 双角字符包括韩语、日语和中文字符以及表情符号。
特性 text 不能包含换行符 (\n) 。
编辑上诉状态
确定是否可以对编辑评审发现的问题提出上诉。
下表介绍了可能的值。
| 值 | 说明 |
|---|---|
| 上诉 | 编辑问题很有吸引力。 |
| AppealPending | 编辑问题可上诉，已提出上诉。 |
| NotAppealable | 编辑问题没有吸引力。 |
添加： 只读
更新： 只读
删除： 只读
编辑位置
编辑评审失败的广告的组件或属性。
添加： 只读
更新： 只读
删除： 只读
编辑原因代码
标识失败原因的代码。 有关可能的原因代码列表，请参阅 编辑原因代码。
添加： 只读
更新： 只读
删除： 只读
编辑状态
资产组的编辑状态。
下表介绍了可能的值。
| 值 | 说明 |
|---|---|
| 活动 | 资产组通过了编辑评审。 |
| ActiveLimited | 资产组在一个或多个市场通过了编辑评审，资产组的一个或多个元素正在另一个市场进行编辑评审。 例如，资产组通过了加拿大的编辑评审，并且仍在美国中等待评审。 |
| 反对 | 资产组编辑评审失败。 |
| 非活动 | 资产组的一个或多个元素正在接受编辑评审。 |
添加： 只读
更新： 只读
删除： 只读
编辑术语
编辑评审失败的术语。
如果术语组合导致失败，或者失败基于策略冲突，则不会设置此字段。
添加： 只读
更新： 只读
删除： 只读
End Date
资产组到期的日期。
如果未指定结束日期，则资产组不会过期。 可以延长结束日期，使资产组符合交付条件，即使在资产组过期后也是如此。
结束日期是包含的。 例如，如果将 “结束日期 ”设置为 2020 年 12 月 31 日，则资产组将在 2020 年 12 月 31 日晚上 11：59 过期。 时间基于在市场活动级别指定的时区。
添加： 选。 若要在添加资产组时不设置结束日期，请不要设置此字段。
更新： 选。 如果未为更新设置任何值，则不会更改此设置。 若要删除当前结束日期并有效地不设置结束日期，请将此字段设置为“delete_value”字符串。 下次检索资产组时，不会设置此字段。
删除： 只读
最终 URL
登陆页 URL。
URL 的域部分与路径 1 和路径 2 字符串组合不能超过 67 个字符。
以下验证规则适用于最终 URL 和最终移动 URL。
URL 的长度限制为 2,048 个字符。 HTTP 或 HTTPS 协议字符串计入 2,048 个字符限制。
最多可为最终 URL 和最终移动 URL 指定 10 个项目;但是，每个列表中的第一项仅用于传递。 该服务最多允许 10 个，以确保潜在的向前兼容性。
每个 URL 由分号和空格 (“分隔;“) 。
仅允许使用“{”和“}”来描述标记，例如“{lpurl}”。
每个 URL 必须是格式正确的 URL，以 http:// 或 https:// 开头。
如果指定“最终移动 URL”，还必须指定“最终 URL”。
添加： 必填
更新： 选。 如果未为更新设置任何值，则不会更改此设置。
删除： 只读
标题
必应可用于优化广告布局的标题列表。
为了在所有广告格式中最大化性能，标题可能不会始终显示在广告中。
从数据模型的角度来看，标题存储为文本资产。 同一资产可由多个广告使用。 例如，如果“无缝集成”是文本资产，它将在同一 Microsoft Advertising 帐户中的所有广告中具有相同的资产标识符。
必须设置 3-15 个标题。 标题在大容量文件中以 JSON 字符串的形式表示。 以下示例 JSON 中包含两个标题。
id和 text 是资产的属性，而 editorialStatus 和 assetPerformanceLabel 是资产链接的属性，即资产与广告之间的关系。 有关详细信息，请参阅下面的 assetPerformanceLabel、 editorialStatus、 id 和 文本 。
[{
"text": "Contoso",
},
{
"text": "Seamless Integration"
}]
注意
在逗号分隔的大容量文件中，需要用一组额外的双引号将资产链接、每个属性键和每个属性字符串值括起来，例如，上面的 JSON 字符串将写成 “[{”“text”“：”Contoso“”}，{“text”“：”“无缝集成”}]”。
下面是批量下载示例，其中还将获取只读属性，例如 id 和 editorialStatus：
[{
"id": 1,
"text": "Contoso",
"editorialStatus": "Active",
"assetPerformanceLabel": "Learning"
},
{
"id": 2,
"text": "Seamless Integration",
"editorialStatus": "Active",
"assetPerformanceLabel": "Learning"
}]
添加： 如果父市场活动未关联到商店，则是必需的;如果父市场活动关联到商店，则为可选。 如果父市场活动关联到商店，并且你指定了标题，则还必须指定长头线、说明和图像。 仅遵循 文本 。 即使帐户中已存在资产，如果包含 ID、assetPerformanceLabel 和 editorialStatus，也会忽略它们。
更新： 选。 若要保留所有现有资产链接，请将此字段设置为空或留空。 如果设置此字段，将替换以前链接到此广告的所有标题。 如果指定此字段，则需要包含 3-15 个标题的列表。 仅遵循 文本 。 即使帐户中已存在资产，如果包含 ID、assetPerformanceLabel 和 editorialStatus，也会忽略它们。
删除： 只读
assetPerformanceLabel
这可让你了解资产的性能。
下载 assetPerformanceLabel 响应式搜索广告时，属性是只读的。 下表介绍了可能的值。
| 值 | 说明 |
|---|---|
| 低 | 此资产的性能较低，建议替换此资产以提高广告性能。 |
| Good | 此资产性能良好。 建议保留此资产并添加更多资产以提高广告性能。 |
| 最好 | 此资产的性能是最好的，建议添加更多类似的资产。 |
| 未分级 | 对此资产没有任何性能评级。 这可能是由于资产处于非活动状态，没有足够的信息来确定其性能，或者没有足够的类似资产与之进行比较。 |
| 学习 | 正在积极评估资产的性能。 评估完成后，资产评级将为“低”、“良好”、“最佳”或“未评级”。 |
editorialStatus
下载响应式搜索广告时， editorialStatus 属性是只读字符串。 下表介绍了可能的值。
| 值 | 说明 |
|---|---|
| 活动 | 资产通过了编辑评审。 |
| ActiveLimited | 资产在一个或多个市场中通过了编辑评审，而资产的一个或多个元素正在另一个市场进行编辑评审。 例如，资产通过了加拿大的编辑评审，仍在美国中等待评审。 |
| 反对 | 资产编辑评审失败。 |
| 非活动 | 资产的一个或多个元素正在接受编辑评审。 |
| 未知 | 保留供以后使用。 |
id
属性 id 是 Microsoft Advertising 帐户中资产的唯一 Microsoft Advertising 标识符。
同一资产可由多个广告使用。 例如，如果“无缝集成”是文本资产，它将在同一 Microsoft Advertising 帐户中的所有广告中具有相同的资产标识符。 上传文本资产后，结果文件将包括资产标识符，例如 ""id:""123，无论资产是新资产还是已存在于帐户的资产库中。
text
每个标题的 text 属性必须至少包含一个单词。 每个标题 text 属性的最大输入长度为 30 个字符。 对于具有双角字符的语言（例如繁体中文），最大输入长度为 15 个字符。 双角字符由你使用的字符而不是市场活动或广告组语言设置的字符集决定。 双角字符包括韩语、日语和中文字符以及表情符号。
特性 text 不能包含换行符 (\n) 。
Id
资产组的系统生成的标识符。
添加： 选。 必须将此字段留空，或指定负标识符。 有关详细信息，请参阅 批量文件架构引用密钥。
更新： 只读和必需
删除： 只读和必需
图像
创建具有不同大小和纵横比的多个图像资产，以便它们可以跨各种发布者和位置灵活显示。
需要至少提供 1 个 LandscapeImageMedia 和 1 个 SquareImageMedia。 总共最多可以保存 20 个图像和总共 5 个徽标。
图像资产在批量文件中以 JSON 字符串的形式表示。 以下示例 JSON 中包含 9 个图像，并且只有 LandscapeImageMedia subType 未裁剪。 是id资产的属性，而 cropHeight、、cropWidthcropX、 cropY和 subType 是资产链接的属性，即资产与广告之间的关系。 有关详细信息，请参阅下面的 cropHeight、 cropWidth、 cropX、 cropY、 id 和 subType 。
[{
"id": 1234567890000,
"subType": "LandscapeImageMedia"
},
{
"id": 1234567890000,
"subType": "SquareImageMedia",
"cropX": 286,
"cropY": 0,
"cropWidth": 628,
"cropHeight": 628
},
{
"id": 1234567890000,
"subType": "LandscapeLogoMedia",
"cropX": 70,
"cropY": 0,
"cropWidth": 200,
"cropHeight": 50
},
{
"id": 1234567890000,
"subType": "SquareLogoMedia",
"cropX": 308,
"cropY": 0,
"cropWidth": 120,
"cropHeight": 120
},
{
"id": 1234567890000,
"subType": "ImageMedia15X10",
"cropX": 129,
"cropY": 0,
"cropWidth": 942,
"cropHeight": 628
},
{
"id": 1234567890000,
"subType": "ImageMedia133X100",
"cropX": 183,
"cropY": 0,
"cropWidth": 835,
"cropHeight": 628
},
{
"id": 1234567890000,
"subType": "ImageMedia178X100",
"cropX": 41,
"cropY": 0,
"cropWidth": 1118,
"cropHeight": 628
},
{
"id": 1234567890000,
"subType": "ImageMedia1x2",
"cropX": 41,
"cropY": 0,
"cropWidth": 500,
"cropHeight": 1000
},
{
"id": 1234567890000,
"subType": "ImageMedia4x1",
"cropX": 60,
"cropY": 0,
"cropWidth": 1000,
"cropHeight": 250
}]
注意
在逗号分隔的大容量文件中，需要用一组额外的双引号将资产链接、每个属性键和每个属性字符串值括起来， 上述 JSON 字符串将写为“[{”id“”：1234567890000，“”subType“”：“”LandscapeImageMedia“”“}，{”“id”：1234567890000，“”subType“”：“”SquareImageMedia “”，“”cropX“”：286，“cropY”：0，“”cropWidth“”：628，“cropHeight”：628}，{“id”“：1234567890000，“”subType“”：“”LandscapeLogoMedia“”，“”cropX“：70，”“cropY”“：0，”cropWidth“：200，”cropHeight“：50}，{”“id”“：1234567890000， ”“subType”“：”“SquareLogoMedia”“，”“cropX”：308，“”cropY“”：0，“cropWidth”：120，“cropHeight”：120}，{“id”“：1234567890000 subType”“：”“ImageMedia15X10”“，”“cropX”：129，“cropY”：0，“cropWidth”：942，“cropHeight”：628}，{“”id“”：1234567890000，“”subType“”：“”ImageMedia133X100“”，“”cropX“”：183，“cropY”“：0，”cropWidth“：835，”cropHeight“”：628}，{“”id“：1234567890000，”“subType”“：”“ImageMedia178X100”“，”“cropX”“：41，”cropY“”：0，“cropWi ”：1118，“cropHeight”“：628}，{”“id”“：1234567890000，”subType“”：“”ImageMedia1X2“”，“”cropX“”：1 41，“”cropY“”：0，“cropWidth”：500，“”cropHeight“”：1000}，{“”id“”：1234567890000，“”subType“”：：“”ImageMedia4X1“”，“”cropX“”：60，“cropY”“：0，”“cropWidth”“：1000，”cropHeight“”：250}]”。
添加： 如果父市场活动未关联到商店，则是必需的;如果父市场活动关联到商店，则为可选。 如果父市场活动关联到某个商店，并且你指定了“图像”，则还必须指定“标题”、“长标题”和“说明”。 每个资产链接仅需要 ID 和 subType 。
更新： 选。 若要保留所有现有资产链接，请将此字段设置为空或留空。 如果设置此字段，将替换以前链接到此广告的任何图像。 如果设置此字段，则每个资产链接只需要 ID 和 subType 。
删除： 只读
cropHeight
要从图像资产源使用的像素数，从裁剪位置开始向上移动。
cropWidth
要从图像资产源使用的像素数，从裁剪X 位置开始，向右移动。
cropX
从图像资产源的左下角开始，这是应用 cropWidth 之前要跳到 x 轴右侧的像素数。
cropY
从图像资产源的左下角开始，这是应用 cropHeight 之前在 y 轴上向上跳过的像素数。
id
属性 id 是 Microsoft Advertising 帐户中资产的唯一 Microsoft Advertising 标识符。
同一图像资产标识符可以在同一广告中多次用于不同的纵横比，也可以由同一 Microsoft Advertising 帐户中的多个广告使用。 可以通过图像批量记录为响应式广告创建 图像 。 然后，可以使用返回的媒体标识符作为图像资产 ID。 图像资产 子类型必须支持添加的图像的纵横比。
亚
属性 subType 表示此图像资产的纵横比。
存储在帐户级别媒体库中 的图像 的真实纵横比可能会有所不同，只要生成的维度导致每个子类型的预期纵横比。
可能的子类型值包括 LandscapeImageMedia、SquareImageMedia、LandscapeLogoMedia、SquareLogoMedia、ImageMedia15X10、ImageMedia133X100、ImageMedia178X100、ImageMedia1X2 和 ImageMedia4X1。 将来可能会添加新的子类型，因此不应依赖于一组固定值。
| 子类型 | 纵横比 | 最小尺寸（以像素为单位） |
|---|---|---|
| LandscapeImageMedia | 1.91:1 | 703 宽 x 368 高 |
| SquareImageMedia | 1:1 | 300 宽度 x 300 高度 |
| LandscapeLogoMedia | 4:1 | 160 宽 x 40 高 |
| SquareLogoMedia | 1:1 | 40 宽度 x 40 高度 |
| ImageMedia15x10 | 1.5:1 | 300 宽度 x 200 高度 |
| ImageMedia133x100 | 1.33:1 | 100 宽 x 75 高 |
| ImageMedia178x100 | 1.78:1 | 624 宽 x 350 高 |
| ImageMedia1x2 | 1:2 | 470 宽 x 940 高 |
| ImageMedia4x1 | 4:1 | 608 宽 x 152 高 |
长标题
必应可用于优化广告布局的长标题列表。
为了在所有广告格式中最大化性能，长标题可能不会始终显示在广告中。
从数据模型的角度来看，长标题存储为文本资产。 同一资产可由多个广告使用。 例如，如果“无缝集成”是文本资产，它将在同一 Microsoft Advertising 帐户中的所有广告中具有相同的资产标识符。
必须设置 1-5 个长标题。 长标题在批量文件中以 JSON 字符串的形式表示。 以下示例 JSON 中包含两个长标题。
id和 text 是资产的属性，而 editorialStatus 和 assetPerformanceLabel 是资产链接的属性，即资产与广告之间的关系。 有关详细信息，请参阅下面的 assetPerformanceLabel、 editorialStatus、 id 和 文本 。
[{
"text": "Find New Customers & Increase Sales!",
},
{
"text": "Start Advertising on Contoso Today."
}]
注意
在逗号分隔的大容量文件中，需要用一组额外的双引号将资产链接、每个属性键和每个属性字符串值括起来，例如，上面的 JSON 字符串将写为 “[{”text“”：“查找新客户 & 增加销售额！”}，{“text”：“”开始在 Contoso Today 上播发广告“。”}”。
下面是批量下载示例，其中还将获取只读属性，例如 id 和 editorialStatus：
[{
"id": 1,
"text": "Find New Customers & Increase Sales!",
"editorialStatus": "Active",
"assetPerformanceLabel": "Learning"
},
{
"id": 2,
"text": "Start Advertising on Contoso Today",
"editorialStatus": "Active",
"assetPerformanceLabel": "Learning"
}]
添加： 如果父市场活动未关联到商店，则是必需的;如果父市场活动关联到商店，则为可选。 如果父市场活动关联到某个商店，并且你指定了 LongHeadlines，则还必须指定标题、说明和图像。 仅遵循 文本 。 即使帐户中已存在资产，如果包含 ID、assetPerformanceLabel 和 editorialStatus，也会忽略它们。
更新： 选。 若要保留所有现有资产链接，请将此字段设置为空或留空。 如果设置此字段，将替换以前链接到此广告的所有标题。 如果指定此字段，则需要包含 1-5 个标题的列表。 仅遵循 文本 。 即使帐户中已存在资产，如果包含 ID、assetPerformanceLabel 和 editorialStatus，也会忽略它们。
删除： 只读
assetPerformanceLabel
这可让你了解资产的性能。
下载 assetPerformanceLabel 响应式搜索广告时，属性是只读的。 下表介绍了可能的值。
| 值 | 说明 |
|---|---|
| 低 | 此资产的性能较低，建议替换此资产以提高广告性能。 |
| Good | 此资产性能良好。 建议保留此资产并添加更多资产以提高广告性能。 |
| 最好 | 此资产的性能是最好的，建议添加更多类似的资产。 |
| 未分级 | 对此资产没有任何性能评级。 这可能是由于资产处于非活动状态，没有足够的信息来确定其性能，或者没有足够的类似资产与之进行比较。 |
| 学习 | 正在积极评估资产的性能。 评估完成后，资产评级将为“低”、“良好”、“最佳”或“未评级”。 |
editorialStatus
下载响应式搜索广告时， editorialStatus 属性是只读字符串。 下表介绍了可能的值。
| 值 | 说明 |
|---|---|
| 活动 | 资产通过了编辑评审。 |
| ActiveLimited | 资产在一个或多个市场中通过了编辑评审，而资产的一个或多个元素正在另一个市场进行编辑评审。 例如，资产通过了加拿大的编辑评审，仍在美国中等待评审。 |
| 反对 | 资产编辑评审失败。 |
| 非活动 | 资产的一个或多个元素正在接受编辑评审。 |
| 未知 | 保留供以后使用。 |
id
属性 id 是 Microsoft Advertising 帐户中资产的唯一 Microsoft Advertising 标识符。
同一资产可由多个广告使用。 例如，如果“无缝集成”是文本资产，它将在同一 Microsoft Advertising 帐户中的所有广告中具有相同的资产标识符。 上传文本资产后，结果文件将包括资产标识符，例如 ""id:""123，无论资产是新资产还是已存在于帐户的资产库中。
text
每个长标题的属性 text 必须至少包含一个单词。 每个标题 text 属性的最大输入长度为 90 个字符。 对于具有双角字符的语言（例如繁体中文），最大输入长度为 45 个字符。 双角字符由你使用的字符而不是市场活动或广告组语言设置的字符集决定。 双角字符包括韩语、日语和中文字符以及表情符号。
特性 text 不能包含换行符 (\n) 。
移动最终 URL
移动登陆页 URL。
以下验证规则适用于最终 URL 和最终移动 URL。
URL 的长度限制为 2,048 个字符。 HTTP 或 HTTPS 协议字符串计入 2,048 个字符限制。
最多可为最终 URL 和最终移动 URL 指定 10 个项目;但是，每个列表中的第一项仅用于传递。 该服务最多允许 10 个，以确保潜在的向前兼容性。
每个 URL 由分号和空格 (“分隔;“) 。
仅允许使用“{”和“}”来描述标记，例如“{lpurl}”。
每个 URL 必须是格式正确的 URL，以 http:// 或 https:// 开头。
如果指定“最终移动 URL”，还必须指定“最终 URL”。
添加： 选
更新： 选。 如果未为更新设置任何值，则不会更改此设置。 如果将此字段设置为 delete_value 字符串，则会删除以前的设置。
删除： 只读
修改时间
上次更新实体的日期和时间。 该值以协调世界时 (UTC) 表示。
注意
日期和时间值反映服务器的日期和时间，而不是客户端。 有关日期和时间格式的信息，请参阅 基元 XML 数据类型中的 dateTime 条目。
添加： 只读
更新： 只读
删除： 只读
父 ID
包含资产组的活动的系统生成的标识符。
此批量字段映射到市场活动记录的 ID 字段。
添加： 只读和必需。 必须指定现有的市场活动标识符，或指定等于父市场活动记录的 ID 字段的负标识符。 如果要将新广告组添加到同一批量文件中的新市场活动，则建议这样做。 有关详细信息，请参阅 批量文件架构引用密钥。
更新： 只读和必需
删除： 只读和必需
路径 1
将追加到显示 URL 的域部分的可选路径的第一部分。 显示 URL 的域部分（例如 https://www.contoso.com ）将从“最终 URL”的域 (“最终 URL” 字段) 生成。 如果为 路径 1 指定了值，则会将其追加到显示 URL。 如果还为 路径 2 指定了一个值，则该值也将追加到 路径 1 后的显示 URL。 例如，如果 最终 URL 包含 https://www.contoso.com， 则路径 1 设置为 subdirectory1， 将路径 2 设置为 subdirectory2，则显示的 URL 将为 https://www.contoso.com/subdirectory1/subdirectory2。
路径可以包含动态参数，例如 {MatchType}。 有关支持的参数列表，请参阅 Microsoft Advertising 帮助文章 我可以使用哪些跟踪或 URL 参数？。
如果包含动态文本字符串，则最大输入长度为 1,000 个字符。 不能输入超过 15 个最终 (不能输入) 字符的动态文本。 如果最终 URL 域的长度和路径组合超过 67 个字符，广告将无法显示，或者将使用 默认文本 。
对于具有双角字符的语言（例如繁体中文），如果包含动态文本字符串，则最大输入长度为 1,000 个字符。 不能输入超过 7 个最终 (不能输入) 字符的动态文本。 如果最终 URL 域和路径的总长度超过 33 个字符，广告将无法显示，或者将使用 默认文本 。 双角字符由使用的字符决定，而不是市场活动或资产组语言设置的字符集。 双角字符包括韩语、日语和中文字符以及表情符号。
路径不能包含正斜杠 (/) 或换行 (\n) 字符。
如果路径包含空格，则会在显示广告时将其替换为下划线 (_) 。
添加： 选
更新： 选。 如果未为更新设置任何值，则不会更改此设置。 如果将此字段设置为 delete_value 字符串，则会删除以前的设置。
删除： 只读
路径 2
将追加到显示 URL 的域部分的可选路径的第二部分。 显示 URL 的域部分（例如 https://www.contoso.com ）将从“最终 URL”的域 (“最终 URL” 字段) 生成。 如果为 路径 1 指定了值，则会将其追加到显示 URL。 如果还为 路径 2 指定了一个值，则该值也将追加到 路径 1 后的显示 URL。 例如，如果 最终 URL 包含 https://www.contoso.com， 则路径 1 设置为 subdirectory1， 将路径 2 设置为 subdirectory2，则显示的 URL 将为 https://www.contoso.com/subdirectory1/subdirectory2。
如果还设置了 路径 1 ，则只能指定 路径 2。
路径可以包含动态参数，例如 {MatchType}。 有关支持的参数列表，请参阅 Microsoft Advertising 帮助文章 我可以使用哪些跟踪或 URL 参数？。
如果包含动态文本字符串，则最大输入长度为 1,000 个字符。 不能输入超过 15 个最终 (不能输入) 字符的动态文本。 如果最终 URL 域的长度和路径组合超过 67 个字符，广告将无法显示，或者将使用 默认文本 。
对于具有双角字符的语言（例如繁体中文），如果包含动态文本字符串，则最大输入长度为 1,000 个字符。 不能输入超过 7 个最终 (不能输入) 字符的动态文本。 如果最终 URL 域和路径的总长度超过 33 个字符，广告将无法显示，或者将使用 默认文本 。 双角字符由使用的字符决定，而不是市场活动或资产组语言设置的字符集。 双角字符包括韩语、日语和中文字符以及表情符号。
路径不能包含正斜杠 (/) 或换行 (\n) 字符。
如果路径包含空格，则会在显示广告时将其替换为下划线 (_) 。
添加： 选
更新： 选。 如果未为更新设置任何值，则不会更改此设置。 如果将此字段设置为 delete_value 字符串，则会删除以前的设置。
删除： 只读
状态
资产组的状态。
可能的值为 Active、 Deleted、 Expired 或 Paused。 “已过期”状态为只读。
添加： 选。 默认值为 Paused。
更新： 选。 如果未为更新设置任何值，则不会更改此设置。
删除： 必填。 “状态”必须设置为 “已删除”。
开始日期
资产组可以开始提供服务的日期;否则，服务可以在资产组处于活动状态的当天开始为资产组提供服务。
开始日期是包含的。 例如，如果将 “开始日期” 设置为 5/5/2020，则资产组将从 2020 年 5 月 5 日 12：00 AM 开始。 时间基于在市场活动级别指定的时区。
添加： 选。 如果未设置此字段，或者提交的日期早于今天日期，则将设置今天的日期，一旦资产组状态处于活动状态，服务就可以开始为资产组提供服务。
更新： 选。 如果未为更新设置任何值，则不会更改此设置。 在提交资产组后（即开始日期到达后），无法更新开始日期。
删除： 只读