通过

广告

  • 项目

广告派生的基础对象，例如展开的文本广告。

此对象还表示标准文本广告。 可以不再创建标准文本广告，但可以检索、暂停、删除和启用它们。 以下方法不适用于派生对象，不应调用。

  • 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 从此广告中删除标签。
Url 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 广告的编辑审批状态。 下面是可能的值。
  • 批准
  • APPROVED_LIMITED
  • UNDER_REVIEW
  • 反对

getStats

获取此广告的性能数据。

若要调用此方法，必须在广告选择器的链中包含方法之一forDateRange。

返回

类型 说明
统计 广告的性能数据。

getType

获取此广告的派生类型。

返回

类型 说明
string 此广告的派生类型。 以下是可能的类型。
  • EXPANDED_TEXT_AD
.

isEnabled

获取一个布尔值，该值指示是否启用此广告。

返回

类型 说明
boolean 如果启用此广告，则 为 true ;否则为 false。

isMobilePreferred

获取一个布尔值，该值指示此广告的首选项是在移动设备还是所有设备上显示。

返回

类型 说明
boolean 如果首选项是在移动设备上显示此广告，则为 true 。 如果 为 false，则首选在所有设备上显示此广告。

isPaused

获取一个布尔值，该值指示此广告是否暂停。

返回

类型 说明
Boolean 如果此广告已暂停，则 为 true ;否则为 false。

isType

包含用于测试广告是否为指定类型的方法。

返回

类型 说明
AdTypeSpace 包含用于测试广告是否为指定类型的方法。

标签

获取用于筛选与此广告关联的标签列表 的选择器 。

返回

类型 说明
LabelSelector 用于筛选与此广告关联的标签列表的选择器。

暂停

暂停此广告。

返回

类型 说明
void 不返回任何内容。

删除

删除此广告。

返回

类型 说明
void 不返回任何内容。

removeLabel (字符串名称)

从广告中删除标签。

参数

名称 类型 说明
name string 标签的区分大小写的名称。 若要获取与此广告关联的标签列表，请参阅 标签。

返回

类型 说明
void 不返回任何内容。

urls

包含用于获取此广告的最终 URL、跟踪模板和自定义参数的方法。

返回

类型 说明
AdUrls 用于获取此广告的最终 URL、跟踪模板和自定义参数的对象。

另请参阅