迁移广告附加信息脚本

重要提示 ：您可以通过旧版 Google Ads 脚本继续使用当前基于 Feed 的附加信息。不过，基于 Feed 的附加信息即将停用，基于素材资源的附加信息将仅在全新 Google Ads 脚本体验中提供。我们建议您尽快将旧版 Google Ads 脚本迁移到新版 Google Ads 脚本。

本文档介绍了用于访问或管理广告附加信息的脚本的迁移过程。自 2022 年 3 月 28 日起，如果客户的脚本用于更新广告附加信息，他们将把基于 Feed 的附加信息迁移到基于素材资源的新附加信息。自 2022 年 5 月 13 日起，如果客户拥有用于提取广告附加信息的脚本（并且没有用于更新广告附加信息的脚本），则其基于 Feed 的附加信息将迁移到基于素材资源的新附加信息。

概览

注意 ：如果您没有任何用于访问或更新广告附加信息的脚本，则无需执行任何操作，您可以参考广告附加信息指南。

基于 Feed 的现有附加信息范式已被弃用，取而代之的是基于素材资源的附加信息。基于 Feed 的附加信息在 Google Ads 界面中称为“旧版”附加信息，而基于素材资源的附加信息在 Google Ads 界面中称为“已升级”附加信息。

从 2022 年 3 月 28 日开始，基于 Feed 的附加信息将迁移到基于素材资源的新附加信息。迁移后，基于 Feed 的附加信息将停止投放。本指南将简要介绍您的 Google Ads 帐号中既有基于 Feed 的广告附加信息，又有基于素材资源的广告附加信息，或者您的帐号中只有基于 Feed 的广告附加信息。

迁移详情

要开始使用或更新基于素材资源的广告附加信息，您必须使用新版 Google Ads 脚本。如需了解新版 Google Ads 脚本体验，请参阅入门指南。

获取广告附加信息

现有的一组广告附加信息选择器（例如 SitelinkSelector）能够提取基于 Feed 的广告附加信息或基于素材资源的广告附加信息。默认情况下，这些选择器会返回当前投放的任何类型的广告附加信息。下表总结了目前投放的广告附加信息的类型（因此将默认返回）：

账号中的广告附加信息类型
仅限基于 Feed 的广告附加信息	默认情况下，系统将返回基于 Feed 的广告附加信息
仅限基于素材资源的广告附加信息	系统会默认返回基于素材资源的广告附加信息
基于 Feed 和基于素材资源的广告附加信息	系统会默认返回基于素材资源的广告附加信息

所有基于 Feed 的广告附加信息迁移完毕后，所有广告附加信息选择器都将默认返回基于素材资源的广告附加信息。但仍然可以通过 withOnlyLegacy 方法提取基于 Feed 的广告附加信息。这对于收集历史指标很有用。

// This will return feed-based sitelink extensions before and after
// March 28, 2022.
const sitelinks = AdsApp.extensions().sitelinks().withOnlyLegacy().get();

在大多数情况下，在基于 Feed 的广告附加信息迁移之前或之后，都不需要更改代码。不过，在某些情况下，可能需要更改代码。

按 ID 过滤广告附加信息

迁移基于 Feed 的广告附加信息时，基于素材资源的相应广告附加信息将具有不同的 ID。这意味着，如果您的脚本目前按 ID 过滤广告附加信息，它将无法提取基于素材资源的广告附加信息。

// If these IDs belong to feed-based sitelink extensions, this code will return
// an empty iterator on or after March 28, 2022 (once the extensions have been
// migrated).
const ids = [123, 456, 789];
const sitelinks = AdsApp.extensions().sitelinks().withIds(ids).get();

为解决此问题，您应按其他属性进行过滤，或更新代码以改用基于素材资源的广告附加信息的 ID。

按统计信息过滤广告附加信息

迁移基于 Feed 的广告附加信息时，相应基于素材资源的广告附加信息的统计信息将会重置。按统计信息过滤广告附加信息时，您应该考虑到这一点。例如，如果您请求在 LAST_MONTH 中添加 Clicks > 100 的附加链接，并且最近迁移了基于 Feed 的广告附加信息，您可能会看到比平时少的广告附加信息。

在为广告附加信息生成效果报告时，您也应注意这一点。迁移基于 Feed 的广告附加信息后，您的报告可能会发生显著变化或下降。

已废弃的方法

在迁移过程中，有几个字段不再受支持。例如，附加摘要信息中已弃用开始日期和结束日期。调用 getStartDate() 将返回 null。此外，系统会记录一条警告消息。请参阅下表，了解哪些方法已废弃：

类	已废弃的方法
宣传信息	没有已废弃的方法
MobileApp	getSchedules
PhoneNumber	getEndDate getStartDate
价格	getEndDate getSchedules getStartDate
站内链接	没有已废弃的方法
Snippet	getEndDate getSchedules getStartDate

更新广告附加信息

在迁移过程中，有几个字段不再受支持。例如，附加摘要信息中已弃用开始日期和结束日期。调用 setStartDate 不会对广告附加信息产生任何影响。此外，系统会记录一条警告消息。请参阅下表，了解哪些方法已废弃：

类	已废弃的方法
宣传信息	没有已废弃的方法
MobileApp	setSchedules
PhoneNumber	clearEndDate clearStartDatesetEndDate setStartDate
价格	clearEndDate clearStartDatesetEndDate setSchedules setStartDate
站内链接	没有已废弃的方法
Snippet	clearEndDate clearStartDatesetEndDate setSchedules setStartDate

创建广告附加信息

现有的一组广告附加信息构建工具（例如 SitelinkBuilder）能够创建基于 Feed 的广告附加信息或基于素材资源的广告附加信息。默认情况下，这些构建器将创建当前投放的任何类型的广告附加信息。下表总结了当前正在投放的广告附加信息的类型（因此系统会默认创建此类附加信息）：

账号中的广告附加信息类型
仅限基于 Feed 的广告附加信息	系统将默认创建基于 Feed 的广告附加信息
仅限基于素材资源的广告附加信息	系统将默认创建基于素材资源的广告附加信息
基于 Feed 和基于素材资源的广告附加信息	系统将默认创建基于素材资源的广告附加信息

在客户迁移完附加信息之后，默认情况下，所有广告附加信息制作工具都会创建基于素材资源的广告附加信息。我们将不再支持创建基于 Feed 的广告附加信息，因为基于 Feed 的广告附加信息将不再投放。

如果您想创建基于 Feed 的附加信息，而不是依赖于默认行为，可以通过调用 build(true) 而不是 build() 来实现，例如：

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(true) means this will create a legacy phone number extension.
  .build(true)
  .getResult();

如果您想创建基于素材资源的附加信息，但您的帐号目前只有基于 Feed 的附加信息，您可以等到 3 月 28 日，或者调用 build(false)。

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(false) means this will create an asset-based phone number extension
  // even if the account currently only has feed-based extensions.
  .build(false)
  .getResult();

不支持的字段

在广告附加信息迁移过程中，某些字段已弃用。例如，附加摘要信息中已弃用开始日期和结束日期。调用 withEndDate 或 withStartDate 不会对扩展程序产生任何影响，系统会记录警告消息。如需了解每个类中已废弃的方法，请参阅下表：

类	已废弃的方法
CalloutBuilder	withMobilePreferred
MobileAppBuilder	withMobilePreferred withSchedules
PhoneNumberBuilder	withEndDate withMobilePreferred withStartDate
PriceBuilder	withEndDate withMobilePreferred withSchedules withStartDate
SitelinkBuilder	withMobilePreferred
SnippetBuilder	withEndDate withMobilePreferred withSchedules withStartDate