此页面由 Cloud Translation API 翻译。

迁移广告附加信息脚本

本文档介绍了用于访问或管理广告附加信息的脚本的迁移流程。自 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`
电话号码	`getEndDate` `getStartDate`
价格	`getEndDate` `getSchedules` `getStartDate`
站内链接	没有已废弃的方法
Snippet	`getEndDate` `getSchedules` `getStartDate`

更新广告附加信息

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

类	已弃用的方法
宣传信息	没有已废弃的方法
MobileApp	`setSchedules`
电话号码	`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`