广告（如展开文字广告）派生自的基本对象。
此对象还表示标准文字广告。 您不再可以创建标准文字广告，但可以检索、暂停、移除和启用它们。 以下方法不适用于派生对象，不应调用。
- getDestinationUrl ()
- getDisplayUrl ()
- getHeadline ()
- isMobilePreferred ()
注意
- 在 2023 年 2 月 1 日之前将加大型文字广告升级为自适应搜索广告。 在此日期之后，您将无法再创建新的或编辑现有的展开文字广告。 有关详细信息，请参阅关于 响应式搜索广告。
- 现有的加大型文字广告将继续投放，并且您将能够查看其效果报告。
- 您仍然可以暂停、启用或移除加大型文字广告。 否则，尝试添加或更新加大型文字广告将导致
CampaignServiceAdTypeInvalid错误。 - 了解有关此更改的详细信息。
方法
| 方法名称 | 返回类型 | 说明 |
|---|---|---|
| applyLabel (字符串名称) | void | 将标签应用于此广告。 |
| asType | AdViewSpace | 包含用于将此广告投射到特定广告类型的方法。 |
| 启用 | void | 启用此广告。 |
| getAdGroup | AdGroup | 获取此广告所属的广告组。 |
| getCampaign | 市场活动 | 获取此广告所属的市场活动。 |
| getDescription | string | 获取此广告的文案文本。 |
| getDestinationUrl | string | 获取用户点击广告时转到的网页的 URL。 |
| getDisplayUrl | string | 获取广告中显示的 URL。 |
| getEntityType | string | 获取此实体的类型。 |
| getHeadline | string | 获取此广告的标题。 |
| getId | string | 获取唯一标识此广告的 ID。 |
| getPolicyApprovalStatus | string | 获取此广告的编辑审批状态。 |
| getStats | 统计 | 获取此广告的效果数据。 |
| getType | string | 获取此广告的派生类型。 |
| isEnabled | boolean | 获取指示是否启用此广告的布尔值。 |
| isMobilePreferred | 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
获取此广告的文案文本。
返回
| 类型 | 说明 |
|---|---|
| string | 广告的文案文本。 |
getDestinationUrl
获取用户点击广告时转到的网页的 URL。
返回
| 类型 | 说明 |
|---|---|
| string | 用户点击广告时转到的网页的 URL。 如果从派生对象调用，则返回 null。 |
getDisplayUrl
获取广告中显示的 URL。
返回
| 类型 | 说明 |
|---|---|
| string | 广告中显示的 URL。 如果从派生对象调用，则返回 null。 |
getEntityType
获取此实体的类型。
返回
| 类型 | 说明 |
|---|---|
| string | 此实体的类型为 Ad。 |
getHeadline
获取此广告的标题。
返回
| 类型 | 说明 |
|---|---|
| string | 广告的标题。 如果从派生对象调用，则返回 null。 |
getId
获取唯一标识此广告的 ID。
返回
| 类型 | 说明 |
|---|---|
| string | 唯一标识此广告的 ID。 |
getPolicyApprovalStatus
获取此广告的编辑审批状态。
返回
| 类型 | 说明 |
|---|---|
| string | 广告的编辑审批状态。 以下是可能的值。
|
getStats
获取此广告的效果数据。
要调用此方法，您必须在广告选择器的链中包含其中一个forDateRange方法。
返回
| 类型 | 说明 |
|---|---|
| 统计 | 广告的效果数据。 |
getType
获取此广告的派生类型。
返回
| 类型 | 说明 |
|---|---|
| string | 此广告的派生类型。 以下是可能的类型。
|
isEnabled
获取指示是否启用此广告的布尔值。
返回
| 类型 | 说明 |
|---|---|
| boolean | 如果启用此广告，则为 true ;否则为 false。 |
isMobilePreferred
获取一个布尔值，指示首选项是希望此广告显示在移动设备上还是在所有设备上显示。
返回
| 类型 | 说明 |
|---|---|
| boolean | 如果首选在移动设备上显示此广告，则为 true 。 如果为 false，则首选是此广告显示在所有设备上。 |
isPaused
获取指示此广告是否已暂停的布尔值。
返回
| 类型 | 说明 |
|---|---|
| Boolean | 如果此广告已暂停，则为 true ;否则为 false。 |
isType
包含用于测试广告是否为指定类型的方法。
返回
| 类型 | 说明 |
|---|---|
| AdTypeSpace | 包含用于测试广告是否为指定类型的方法。 |
标签
获取用于筛选与此广告关联的标签列表的 选择器 。
返回
| 类型 | 说明 |
|---|---|
| LabelSelector | 用于过滤与此广告关联的标签列表的选择器。 |
暂停
暂停此广告。
返回
| 类型 | 说明 |
|---|---|
| void | 不返回任何内容。 |
remove
删除此广告。
返回
| 类型 | 说明 |
|---|---|
| void | 不返回任何内容。 |
removeLabel (字符串名称)
从广告中删除标签。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
| name | string | 标签的名称（区分大小写）。 要获取与此广告关联的标签列表，请参阅 标签。 |
返回
| 类型 | 说明 |
|---|---|
| void | 不返回任何内容。 |
urls
包含用于获取此广告的最终 URL、跟踪模板和自定义参数的方法。
返回
| 类型 | 说明 |
|---|---|
| AdUrls | 用于获取此广告的最终 URL、跟踪模板和自定义参数的对象。 |