通过

ExpandedTextAd

包含用于管理扩展文本广告的方法。

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

getStats

获取此广告的性能数据。

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

返回

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

getType

获取此广告的派生类型。

返回

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

isEnabled

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

返回

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

isPaused

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

返回

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

isType

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

返回

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

标签

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

返回

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

暂停

暂停此广告。

返回

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

删除

删除此广告。

返回

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

removeLabel (字符串名称)

从广告中删除标签。

参数

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

返回

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

urls

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

返回

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

另请参阅

  • Last updated on