包含用于定义和创建扩展文本广告的方法。 有关生成器的信息，请参阅 Builders。
注意
-
在 2023 年 2 月 1 日之前，将展开的文本广告升级到响应式搜索广告。 在此日期之后，你将无法再创建新的或编辑现有的扩展文本广告。 有关详细信息，请参阅 关于响应式搜索广告。
- 现有的扩展文本广告将继续投放，你将能够查看其性能报告。
- 你仍然可以暂停、启用或删除展开的文本广告。 否则，尝试添加或更新展开的文本广告将导致
CampaignServiceAdTypeInvalid 错误。
-
详细了解此更改。
用法示例：
var operation = adGroup.newAd().expandedTextAdBuilder()
.withHeadlinePart1('FIRST PART OF TITLE GOES HERE')
.withHeadlinePart2('SECOND PART OF TITLE GOES HERE')
.withDescription('AD TEXT GOES HERE')
.withFinalUrl('LANDING PAGE URL GOES HERE')
.build();
// See the Builders topic for performance considerations
// when using the operation object's methods.
if (!operation.isSuccessful()) {
for (var error of operation.getErrors()) {
Logger.log(`${error}\n`);
}
}
方法
build
创建广告并返回一个操作对象，用于检查脚本是否成功添加了广告。
有关可添加到广告组的广告数量限制，请参阅 实体层次结构限制。
返回
withCustomParameters (Object customParameters)
设置广告的自定义参数。
自定义参数有助于跨多个 URL 共享动态信息。 有关其用法的详细信息，请参阅 自定义参数。
参数
| 名称 |
类型 |
说明 |
| customParameters |
Object |
要应用于广告的最终 URL 的自定义参数的映射。 例如， {key1: 'value1', key2: 'value2', key3: 'value3'}其中键是自定义参数的名称，值是参数的值。 名称最多可包含 16 个 8 字节字符，值最多可包含 200 个 8 字节字符。 |
返回
withDescription (字符串说明)
设置广告的第一个说明。 此方法已弃用，转而 使用与Description1 (字符串 description1) 。
参数
| 名称 |
类型 |
说明 |
| 说明 |
string |
广告的第一个说明。 有关复制限制和包括动态文本字符串的信息，请参阅 必应广告 API。 |
返回
withDescription1 (string description1)
设置广告的第一个说明。 此方法设置的字段 与与description 相同的字段 (字符串说明) 。
参数
| 名称 |
类型 |
说明 |
| description1 |
string |
广告的第一个说明。 有关复制限制和包括动态文本字符串的信息，请参阅 必应广告 API。 |
返回
withDescription2 (string description2)
设置广告的第二个说明。
参数
| 名称 |
类型 |
说明 |
| description2 |
string |
广告的第二个说明。 有关复制限制和包括动态文本字符串的信息，请参阅 必应广告 API。 |
返回
withFinalUrl (string finalUrl)
设置广告的登陆页 URL。
参数
| 名称 |
类型 |
说明 |
| finalUrl |
string |
广告的登陆页 URL。 有关 URL 限制的信息，请参阅 必应广告 API。 |
返回
withHeadlinePart1 (字符串标题Part1)
设置广告标题的第一部分。
参数
| 名称 |
类型 |
说明 |
| headlinePart1 |
string |
广告标题的第一部分。 当 Microsoft 使用标题的第 1、2 和 3 部分生成广告标题时，它会使用“ - ”连接部分。 不要在任何标题部分指定短划线。 标题的每个部分必须至少包含一个单词。 有关其他标题限制并在标题中包含动态文本字符串的信息，请参阅 必应广告 API。 |
返回
withHeadlinePart2 (字符串标题Part2)
设置广告标题的第二部分。
参数
| 名称 |
类型 |
说明 |
| headlinePart2 |
string |
广告标题的第二部分。 当 Microsoft 使用标题的第 1、2 和 3 部分生成广告标题时，它会使用“ - ”连接部分。 不要在任何标题部分指定短划线。 标题的每个部分必须至少包含一个单词。 有关其他标题限制并在标题中包含动态文本字符串的信息，请参阅 必应广告 API。 |
返回
withHeadlinePart3 (字符串标题Part3)
设置广告标题的第三部分。
参数
| 名称 |
类型 |
说明 |
| headlinePart3 |
string |
广告标题的第三部分。 当 Microsoft 使用标题的第 1、2 和 3 部分生成广告标题时，它会使用“ - ”连接部分。 不要在任何标题部分指定短划线。 标题的每个部分必须至少包含一个单词。 有关其他标题限制并在标题中包含动态文本字符串的信息，请参阅 必应广告 API。 |
返回
withMobileFinalUrl (字符串 mobileFinalUrl)
为移动设备设置广告的最终 URL。
最后一个 URL 标识用户在单击广告时将访问的网页。 若要为移动设备指定最终 URL，请先为非移动设备指定最终 URL， (请参阅 withFinalUrl()) 。
有关详细信息，请参阅 我可以使用哪些跟踪或 URL 参数？
参数
| 名称 |
类型 |
说明 |
| mobileFinalUrl |
string |
移动设备的最终 URL。 |
返回
withPath1 (字符串 urlPath1)
设置要追加到广告显示 URL 的第一个可选路径。
参数
| 名称 |
类型 |
说明 |
| mobileFinalUrl |
string |
要追加到广告显示 URL 的第一个可选路径。 Microsoft 使用 中指定的 withFinalUrl 域作为显示 URL。 如果最终 URL 的域 contoso.com 并且路径为 shoes，则广告的显示 URL 将 contoso.com/shoes。 有关使用情况和限制，请参阅 Path1。 |
返回
withPath2 (字符串 urlPath2)
设置要追加到广告显示 URL 的第二个可选路径。
参数
| 名称 |
类型 |
说明 |
| mobileFinalUrl |
string |
要追加到广告显示 URL 的第二个可选路径。 若要指定第二个路径，请先指定第一个路径， (请参阅 withPath1) 。 Microsoft 使用 中指定的 withFinalUrl 域作为显示 URL。 如果最终 URL 的域 contoso.com，第一个路径是 鞋，第二个路径是 女士，则广告的显示 URL contoso.com/shoes/ladies。 有关使用情况和限制，请参阅 Path2。 |
返回
withTrackingTemplate (string trackingTemplate)
设置广告的跟踪模板。
跟踪模板与关键字 (keyword) 的 FinalUrl 一起使用，以创建广告使用的目标 URL。 有关详细信息，请参阅 我可以使用哪些跟踪或 URL 参数？
参数
| 名称 |
类型 |
说明 |
| trackingTemplate |
string |
要用于此广告的跟踪模板。 |
返回