此页面由 Cloud Translation API 翻译。

迁移广告附加信息脚本

本文档介绍了访问或管理广告附加信息自 2022 年 3 月 28 日起，使用脚本的客户将更新广告附加信息会将基于 Feed 的附加信息迁移到新的基于素材资源的附加信息。自 2022 年 5 月 13 日起，使用脚本提取功能的客户广告附加信息（无需更新广告附加信息的脚本）将基于 Feed 已迁移到基于素材资源的新附加信息。

概览

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

自 2022 年 3 月 28 日起，基于 Feed 的附加信息将迁移至新版基于素材资源的附加信息 - 迁移后，基于 Feed 的附加信息将停止投放。本指南概述了您是否同时使用基于 Feed 和基于 Feed 的迁移，您的 Google Ads 账号中基于素材资源的广告附加信息，或者只有基于 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 的广告附加信息时，对应的基于素材资源的广告其统计信息将会重置。您应该考虑这一点。例如，如果您请求附加信息Clicks > 100在LAST_MONTH展示，您看到的广告会减少您的附加信息（例如基于 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`