隆重推出 Facebook 图谱 API v17.0 和市场营销 API v17.0

今天，我们隆重推出 Facebook 图谱 API v17.0 和市场营销 API v17.0。作为此次版本发布的一部分，我们在下方重点列出了我们认为对部分开发者社群至关重要的变更。这些变更包括公告、产品更新和停用通知，我们认为这些变更与您的应用程序和我们平台之间的集成息息相关。

如需获取所有变更的完整列表及变更详情，请访问我们的更新日志。

停用及重大变更

停用广告策略

自 2022 年 10 月 28 日起，Beta 测试版产品“广告策略”已停用。因此，随着市场营销 API v17.0 的发布，我们将在广告系列端点上停用 ad_strategy_id 和 ad_strategy_group_id 字段。

停用线下转化 API

自 2023 年 2 月起，转化 API 完全支持线下事件，确保用户可享受到当前线下转化 API 端点提供的同等功能。通过将网站事件 API 和线下事件 API 合并成一个 API，我们希望能简化和改善广告主对其跨渠道营销数据的使用方式，以便改善广告优化、自定义受众和成效衡量。

从 2023 年 5 月 23 日发布的图谱 API v17.0 开始，线下转化 API 将不再支持线下事件。我们建议，拥有线下转化 API 集成的广告主将其集成转换为转化 API 集成，且在转换成功之前不要更新线下转化 API。

停用旧版目标创建流程

正如 2021 年 12 月的公告所述，我们已重新设计新建广告系列时的目标选择体验，以便有效指导广告主进行广告系列设置，帮助他们更好地实现营销目标。全新成效驱动型广告体验促使市场营销 API 发生变更。

我们将从市场营销 API v17.0 的发布开始，停用旧版体验和目标。使用市场营销 API v17.0 时，您只能使用成效驱动型广告体验目标创建广告系列，旧版目标的 API 将停用。在此版本中，现有旧版广告系列及复制现有旧版广告系列的广告系列仍受支持，不受影响。详情请参阅我们近期的开发者博文。

必须提供进阶赋能型素材标准美化字段

今年早些时候，我们在市场营销 API 中推出了进阶赋能型素材标准美化。自 2023 年 5 月 23 日起，市场营销 API 用户必须在“enroll_status”字段中提供“OPT_IN”或“OPT_OUT”，以指明广告对进阶赋能型素材标准美化的注册情况。如果该字段为空，用户将收到错误消息，系统将指示用户填写此字段。如需详细了解市场营销 API 中的进阶赋能型素材标准美化，请参阅此开发者博文。

以下端点受到影响：

• POST /{ad-account-id}/adcreatives
• POST /{ad-account-id}/ads

停用直播类进阶赋能型目录广告

随着市场营销 API v17.0 的发布，我们将停用直播类进阶赋能型目录广告（直播类 A+CA）目录用途。电商目录广告是推荐的直播类 A+CA 广告替代方案。请参阅这篇创建电商目录的指南。下方端点将停用：

• 创建直播类 A+CA 广告目录：包含行业 media_titles 的 owned_product_catalogs 连线
• 上传媒体标题信息库：直播类 A+CA 广告目录的 product_feeds 连线
• 创建媒体标题项：直播类 A+CA 广告目录的 media_titles 连线
• 使用直播类 A+CA 广告目录创建广告系列：在 L3、L2 或 L1 级附有 DAS 目录的 campaigns 连线

在 2023 年 8 月 21 日，上述变更将适用于所有市场营销 API 版本，并且我们将暂停在 L3、L2 或 L1 级附有直播类 A+CA 广告目录的所有广告系列。

停用即阅文 API

由于即阅文产品已于 2023 年 4 月 20 日停用，支持发行商管理即阅文的 API 现在将停用。

要求用户帐户必须具备业务管理权限

之前，系统会返回附加的业务管理页面，不需要用户帐户具备 business_management 访问权限。自 2023 年 5 月 23 日起，如果您想要继续获得对业务管理页面的访问权限，则必须具备 business_management 权限。有关此权限的详情，请参阅 business_management 页面。

API 版本停用信息：

作为 Facebook 图谱 API 和市场营销 API 版本控制计划的一部分，请注意近期的停用信息：

图谱 API

• 2023 年 6 月 8 日：图谱 API v10.0 将停用，并从开放平台移除
• 2023 年 9 月 14 日：图谱 API v11.0 将停用，并从开放平台移除
• 2024 年 2 月 8 日：图谱 API v12.0 将停用，并从开放平台移除

市场营销 API

• 2023 年 8 月 15 日：市场营销 API v14.0 将停用，并从开放平台移除
• 2023 年 8 月 15 日：市场营销 API v15.0 将停用，并从开放平台移除

为避免对您的业务造成干扰，我们建议您将所有调用迁移到今天发布的最新版 API 中。

Facebook 开放平台 SDK

作为我们开放平台 SDK 两年停用计划的一部分，请留意近期的停用和废弃信息：

• 2023 年 6 月：Facebook 开放平台 SDK v9.0 或更低版本将废弃
• 2023 年 10 月：Facebook 开放平台 SDK v11.0 或更低版本将废弃
• 2024 年 2 月：Facebook 开放平台 SDK v12.0 或更低版本将废弃