包含用于管理加大型文字广告的方法。
此对象派生自 Ad 对象。 方法列表包括所有适用的继承方法。
注意
- 在 2023 年 2 月 1 日之前将加大型文字广告升级为自适应搜索广告。 在此日期之后，您将无法再创建新的或编辑现有的展开文字广告。 有关详细信息，请参阅关于 响应式搜索广告。
- 现有的加大型文字广告将继续投放，并且您将能够查看其效果报告。
- 您仍然可以暂停、启用或移除加大型文字广告。 否则，尝试添加或更新加大型文字广告将导致
CampaignServiceAdTypeInvalid错误。 - 了解有关此更改的详细信息。
方法
| 方法名称 | 返回类型 | 说明 | 继承 |
|---|---|---|---|
| applyLabel (字符串名称) | void | 将标签应用于此广告。 | 否 |
| asType | AdViewSpace | 包含用于将此广告投射到特定广告类型的方法。 | 是 |
| 启用 | void | 启用此广告。 | 是 |
| getAdGroup | AdGroup | 获取此广告所属的广告组。 | 是 |
| getCampaign | 市场活动 | 获取此广告所属的市场活动。 | 是 |
| getDescription | string | 获取此广告的第一个说明。 此方法已弃用，而改用 getDescription1。 | 是 |
| getDescription1 | string | 获取此广告的第一个说明。 此方法返回与 getDescription 相同的值。 | 否 |
| getDescription2 | string | 获取此广告的第二个说明。 | 否 |
| getEntityType | string | 获取此实体的类型。 | 是 |
| getHeadlinePart1 | string | 获取此广告标题的第一部分。 | 否 |
| getHeadlinePart2 | string | 获取此广告标题的第二部分。 | 否 |
| getHeadlinePart3 | string | 获取此广告标题的第三部分。 | 否 |
| getId | string | 获取唯一标识此广告的 ID。 | 是 |
| getPath1 | string | 获取附加到此广告的显示 URL 的可选第一路径。 | 否 |
| getPath2 | string | 获取附加到此广告的显示 URL 的可选第二路径。 | 否 |
| getPolicyApprovalStatus | string | 获取此广告的编辑审批状态。 | 是 |
| getStats | 统计 | 获取此广告的效果数据。 | 是 |
| getType | string | 获取此广告的派生类型。 | 是 |
| isEnabled | boolean | 获取指示是否启用此广告的布尔值。 | 是 |
| isPaused | 布尔值 | 获取指示此广告是否已暂停的布尔值。 | 是 |
| isType | AdTypeSpace | 包含用于测试广告是否为指定类型的方法。 | 是 |
| 标签 | LabelSelector | 获取用于筛选与此广告关联的标签列表的 选择器 。 | 否 |
| 暂停 | void | 暂停此广告。 | 是 |
| remove | void | 删除此广告。 | 是 |
| removeLabel (字符串名称) | void | 从此广告中删除标签。 | 否 |
| urls | AdUrls | 包含用于获取此广告的最终 URL、跟踪模板和自定义参数的方法。 | 是 |
applyLabel (字符串名称)
将标签应用于广告。
最多可以向广告应用 50 个标签。 有关向实体添加标签的示例，请参阅 使用标签。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
| name | string | 标签的名称（区分大小写）。 若要获取此帐户中可应用的标签列表，请参阅 AdsApp.labels。 |
返回
| 类型 | 说明 |
|---|---|
| void | 不返回任何内容。 |
asType
包含用于将此广告投射到特定广告类型的方法。
返回
| 类型 | 说明 |
|---|---|
| AdViewSpace | 包含用于将此广告投射到特定广告类型的方法。 |
启用
启用此广告。 (继承的)
返回
| 类型 | 说明 |
|---|---|
| void | 不返回任何内容。 |
getAdGroup
获取此广告所属的广告组。
返回
| 类型 | 说明 |
|---|---|
| AdGroup | 此广告所属的广告组。 |
getCampaign
获取此广告所属的市场活动。
返回
| 类型 | 说明 |
|---|---|
| 市场活动 | 此广告所属的市场活动。 |
getDescription
获取此广告的第一个说明。 此方法已弃用，而改用 getDescription1。
返回
| 类型 | 说明 |
|---|---|
| string | 广告的第一个说明。 |
getDescription1
获取此广告的第一个说明。 此方法返回与 getDescription 相同的值。
返回
| 类型 | 说明 |
|---|---|
| string | 广告的第一个说明。 |
getDescription2
获取此广告的第二个说明。
返回
| 类型 | 说明 |
|---|---|
| string | 广告的第二个说明。 |
getEntityType
获取此实体的类型。
返回
| 类型 | 说明 |
|---|---|
| string | 此实体的类型为 Ad。 |
getHeadlinePart1
获取此广告标题的第一部分。
返回
| 类型 | 说明 |
|---|---|
| string | 此广告标题的第一部分。 |
getHeadlinePart2
获取此广告标题的第二部分。
返回
| 类型 | 说明 |
|---|---|
| string | 此广告标题的第二部分。 |
getHeadlinePart3
获取此广告标题的第三部分。
返回
| 类型 | 说明 |
|---|---|
| string | 此广告标题的第三部分。 |
getId
获取唯一标识此广告的 ID。
返回
| 类型 | 说明 |
|---|---|
| string | 唯一标识此广告的 ID。 |
getPath1
获取附加到此广告的显示 URL 的可选第一路径。
返回
| 类型 | 说明 |
|---|---|
| string | 附加到此广告的显示 URL 的第一个路径。 |
getPath2
获取附加到此广告的显示 URL 的可选第二路径。
返回
| 类型 | 说明 |
|---|---|
| string | 附加到此广告的显示 URL 的第二个路径。 |
getPolicyApprovalStatus
获取此广告的编辑审批状态。
返回
| 类型 | 说明 |
|---|---|
| string | 广告的编辑审批状态。 以下是可能的值。
|
getStats
获取此广告的效果数据。
要调用此方法，您必须在广告选择器的链中包含其中一个forDateRange方法。
返回
| 类型 | 说明 |
|---|---|
| 统计 | 广告的效果数据。 |
getType
获取此广告的派生类型。
返回
| 类型 | 说明 |
|---|---|
| string | 此广告的派生类型。 以下是可能的类型。
|
isEnabled
获取指示是否启用此广告的布尔值。
返回
| 类型 | 说明 |
|---|---|
| boolean | 如果启用此广告，则为 true ;否则为 false。 |
isPaused
获取指示此广告是否已暂停的布尔值。
返回
| 类型 | 说明 |
|---|---|
| Boolean | 如果此广告已暂停，则为 true ;否则为 false。 |
isType
包含用于测试广告是否为指定类型的方法。
返回
| 类型 | 说明 |
|---|---|
| AdTypeSpace | 包含用于测试广告是否为指定类型的方法。 |
标签
获取用于筛选与此广告关联的标签列表的 选择器 。
返回
| 类型 | 说明 |
|---|---|
| LabelSelector | 用于过滤与此广告关联的标签列表的选择器。 |
暂停
暂停此广告。
返回
| 类型 | 说明 |
|---|---|
| void | 不返回任何内容。 |
remove
删除此广告。
返回
| 类型 | 说明 |
|---|---|
| void | 不返回任何内容。 |
removeLabel (字符串名称)
从广告中删除标签。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
| name | string | 标签的名称（区分大小写）。 要获取与此广告关联的标签列表，请参阅 标签。 |
返回
| 类型 | 说明 |
|---|---|
| void | 不返回任何内容。 |
urls
包含用于获取此广告的最终 URL、跟踪模板和自定义参数的方法。
返回
| 类型 | 说明 |
|---|---|
| AdUrls | 用于获取此广告的最终 URL、跟踪模板和自定义参数的对象。 |