包含用于定义和创建自适应搜索广告的方法。 有关生成器的信息，请参阅 生成器。
示例用法：
var operation = adGroup.newAd().responsiveSearchAdBuilder()
.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`);
}
}
方法
addDescription (字符串说明、字符串固定)
将提供的说明添加到当前说明列表中。 必须使用此方法或 addDescription () 方法指定至少 2 个说明。
参数
| 名称 |
类型 |
说明 |
| 说明 |
string |
要添加的广告说明。 有关限制和包含动态文本字符串的信息，请参阅 必应广告 API。 |
| 固定 |
string |
可选的固定位置。
说明的可能值为：DESCRIPTION_1、DESCRIPTION_2 |
| text |
string |
此资产的文本。 |
返回
addHeadline (字符串标题，字符串固定)
将提供的标题添加到当前标题列表。 必须使用此方法或 addHeadline () 方法指定至少 3 个标题。
参数
| 名称 |
类型 |
说明 |
| 标题 |
string |
要添加的广告标题。 有关限制和包含动态文本字符串的信息，请参阅 必应广告 API。 |
| 固定 |
string |
可选的固定位置。
标题的可能值为：HEADLINE_1、HEADLINE_2 HEADLINE_3 |
返回
build
创建广告并返回用于检查脚本是否成功添加广告的操作对象。
有关可添加到广告组的广告数量限制，请参阅 实体层次结构限制。
返回
withCustomParameters (对象 customParameters)
设置广告的自定义参数。
自定义参数有助于跨多个 URL 共享动态信息。 有关其用法的详细信息，请参阅 自定义参数。
参数
| 名称 |
类型 |
说明 |
| customParameters |
Object |
最多可应用于广告最终 URL 的自定义参数的映射。 例如， {key1: 'value1', key2: 'value2', key3: 'value3'}其中 key 是自定义参数的名称，value 是参数的值。 该名称最多可包含 16 个 8 字节字符，值最多可包含 200 个 8 字节字符。 |
返回
withDescriptions (object[] descriptions)
设置广告的说明。
参数
返回
withFinalUrl (string finalUrl)
设置广告的登陆页 URL。
参数
| 名称 |
类型 |
说明 |
| finalUrl |
string |
广告的登陆页 URL。 有关 URL 限制的信息，请参阅 必应广告 API。 |
返回
withFinalUrlSuffix (字符串 finalUrlSuffix)
设置广告的最终 URL 后缀。
参数
| 名称 |
类型 |
说明 |
| finalUrl |
string |
广告的最终 URL 后缀。 有关 URL 限制的信息，请参阅 必应广告 API。 |
返回
withHeadlines (object[] 标题
设置广告标题。
参数
返回
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 |
用于此广告的跟踪模板。 |
返回