包含用于定义和创建加大型文字广告的方法。 有关生成器的信息，请参阅 生成器。
注意
- 在 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 (对象 customParameters)
设置广告的自定义参数。
自定义参数有助于跨多个 URL 共享动态信息。 有关其用法的详细信息，请参阅 自定义参数。
参数
| 名称 |
类型 |
说明 |
| customParameters |
Object |
最多可应用于广告最终 URL 的自定义参数的映射。 例如， {key1: 'value1', key2: 'value2', key3: 'value3'}其中 key 是自定义参数的名称，value 是参数的值。 该名称最多可包含 16 个 8 字节字符，值最多可包含 200 个 8 字节字符。 |
返回
withDescription (字符串说明)
设置广告的第一个说明。 此方法已弃用，改用 withDescription1 (字符串 description1) 。
参数
| 名称 |
类型 |
说明 |
| 说明 |
string |
广告的第一个说明。 有关复制限制和包含动态文本字符串的信息，请参阅 必应广告 API。 |
返回
withDescription1 (字符串 description1)
设置广告的第一个说明。 此方法设置与 withDescription 相同的字段 (字符串说明) 。
参数
| 名称 |
类型 |
说明 |
| description1 |
string |
广告的第一个说明。 有关复制限制和包含动态文本字符串的信息，请参阅 必应广告 API。 |
返回
withDescription2 (字符串 description2)
设置广告的第二个说明。
参数
| 名称 |
类型 |
说明 |
| description2 |
string |
广告的第二个说明。 有关复制限制和包含动态文本字符串的信息，请参阅 必应广告 API。 |
返回
withFinalUrl (string finalUrl)
设置广告的登陆页 URL。
参数
| 名称 |
类型 |
说明 |
| finalUrl |
string |
广告的登陆页 URL。 有关 URL 限制的信息，请参阅 必应广告 API。 |
返回
withHeadlinePart1 (字符串 headlinePart1)
设置广告标题的第一部分。
参数
| 名称 |
类型 |
说明 |
| headlinePart1 |
string |
广告标题的第一部分。 当 Microsoft 使用广告标题的第 1、2 和 3 部分生成广告标题时，它会使用“ - ”将各个部分连接起来。 不要在任何标题部件中指定虚折号。 标题的每个部分必须至少包含一个单词。 有关其他游戏限制以及如何在游戏中包含动态文本字符串的信息，请参阅 必应广告 API。 |
返回
withHeadlinePart2 (字符串 headlinePart2)
设置广告标题的第二部分。
参数
| 名称 |
类型 |
说明 |
| headlinePart2 |
string |
广告标题的第二部分。 当 Microsoft 使用广告标题的第 1、2 和 3 部分生成广告标题时，它会使用“ - ”将各个部分连接起来。 不要在任何标题部件中指定虚折号。 标题的每个部分必须至少包含一个单词。 有关其他游戏限制以及如何在游戏中包含动态文本字符串的信息，请参阅 必应广告 API。 |
返回
withHeadlinePart3 (字符串 headlinePart3)
设置广告标题的第三部分。
参数
| 名称 |
类型 |
说明 |
| 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，第一个路径是 shoes，第二个路径是 ladies，则广告的显示 URL 为 contoso.com/shoes/ladies。 有关用法和限制，请参阅 Path2。 |
返回
withTrackingTemplate (字符串 trackingTemplate)
设置广告的跟踪模板。
跟踪模板与关键字 (keyword) 的 FinalUrl 一起使用，以创建广告使用的目标 URL。 有关详细信息，请参阅我 可以使用哪些跟踪或 URL 参数？
参数
| 名称 |
类型 |
说明 |
| trackingTemplate |
string |
用于此广告的跟踪模板。 |
返回