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

2026年7月29日

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

发布者 Ayyad Farah, Manjari Jain

图谱 API v26.0 和市场营销 API v26.0 包含新增功能、弃用功能和重大变更。查看以下重点内容，并访问 V26.0 更新日志了解完整的变更列表和详细信息。

重要日期和变更

图谱 API - 电商订单管理：自 2026 年 7 月 29 日起，对 v26.0 及更高版本受影响端点的调用将被阻止。这些端点将于 2026 年 10 月 27 日从所有其余图谱 API 版本中移除，之后调用这些端点将返回错误。目前没有替代 API 可用。
图谱 API - Rights Manager 所有者字段：自 2026 年 7 月 29 日发布的 v26.0 版本起，将提供返回 RightsHolderOwner 类型的替代字段，已停用的所有者字段将不再返回。在 v26.0 发布后的两年内，已停用字段在 v25.0 及更早版本中仍然可用。
图谱 API - 旧版协议功能：自 2026 年 7 月 29 日起，v26.0 调用中将移除五项旧版行为。自 2026 年 10 月 27 日起，所有其余的受支持图谱 API 版本都将适用相同的行为。
市场营销 API - WhatsApp 动态广告：v26.0 版本自 2026 年 7 月 29 日起新增扩展身份、定位、优化和创意功能。
市场营销 API - 住房、就业以及金融产品和服务类广告系列的进阶赋能型受众：自 2026 年 7 月 29 日发布的 v26.0 版本起，具有受限定位的新建或复制广告组必须明确地将 advantage_audience 设置为 1 或 0。默认或放宽设置仍将其默认值设为 1，现有的广告组更新将不受影响。
市场营销 API - Instagram 探索动态：自 2026 年 7 月 29 日发布的 v26.0 起，该版位将停用。开发者应从版位配置中移除“探索”。
市场营销 API - 网站 + 应用广告系列的“仅限网站”目标位置：自 2026 年 7 月 29 日发布的 v26.0 版本起，广告系列使用“网站和应用”转化发生位置时，广告不得使用 applink_treatment 设为 web_only 的创意。该限制于 2026 年 10 月 27 日起适用于所有市场营销 API 版本。
市场营销 API - Messenger 快拍：自 2026 年 7 月 29 日发布的 v26.0 版本调用开始，在创建或更新广告组时，story 值将从 messenger_positions 中静默移除。该弃用措施将于 2026 年 10 月 27 日应用于所有市场营销 API 版本，包括未指定版本的调用。
市场营销 API - 调研广告创建：从 2026 年 7 月 29 日发布的 v26.0 开始，创建调研创意或将广告更改为使用调研创意的请求将被拒绝。不更改创意的现有广告更新仍受支持。该弃用措施将于 2026 年 10 月 27 日应用于所有市场营销 API 版本。
图谱 API 和市场营销 API - 投放预估字段：自 2026 年 7 月 29 日起，daily_outcomes_curve、budget_guardrail 和 estimate_dau 响应字段将从 v26.0 调用中移除，且自 2026 年 10 月 27 日起，这些字段将从所有其他受支持的版本中移除。目前没有替代 API 可用。
图谱 API 版本停用：图谱 API v20.0 于 2026 年 9 月 24 日停用并移除。图谱 API v21.0 于 2027 年 1 月 21 日停用并移除。

常规更新

市场营销 API：扩展 WhatsApp 动态广告支持

自 2026 年 7 月 29 日发布的市场营销 API v26.0 起，WhatsApp 动态广告支持更多身份、定位、优化和创意功能。

WhatsApp 身份：第三方市场营销 API 调用者必须在用于投放到 WhatsApp 动态的广告创意中明确添加 wamo_whatsapp_identity_spec。系统不会自动为这些调用者默认应用 WhatsApp 身份。
未知年龄定位：当选择 WhatsApp 动态版位且未设置 user_age_unknown 时，该字段将默认为 true，这意味着广告系列可触达 WhatsApp 上年龄未知的用户。
优化：使用“销量”、“潜在客户”和“互动”目标时，支持针对站外转化进行转化优化。同时也支持落地页浏览量优化。
创意格式：轮播广告最多支持 10 张图卡。

有关详细信息，请参阅版位定位和基本定位文档。

停用及重大变更

图谱 API 和市场营销 API：移除“投放预估”字段

由于支持这些值的服务已停用，daily_outcomes_curve, budget_guardrail 和 estimate_dau 字段将从投放预估端点响应中移除。从 2026 年 7 月 29 日发布的图谱 API v26.0 和市场营销 API v26.0 开始，这些字段将不再返回。该变更将于 2026 年 10 月 27 日适用于所有其余受支持的图谱 API 和市场营销 API 版本。目前没有替代 API 可用。

开发者应在适用的移除日期之前，移除对这些字段的任何使用或引用。

典型的受影响端点包括：

GET /{ad-account-id}/delivery_estimate - 广告账户投放预估
GET /{adset-id}/delivery_estimate - 广告组投放预估

完整的字段和端点列表将在 V26.0 更新日志中提供。

图谱 API：电商订单管理 API 停用

自 2026 年 7 月 29 日起，调用图谱 API v26.0 及更高版本中这些端点的应用将被阻止。这些端点将于 2026 年 10 月 27 日在所有其余图谱 API 版本中移除，之后调用这些端点将返回错误。

针对店铺的直接在 Facebook 和 Instagram 结账的体验已完全停用。电商订单管理 API 支持第三方平台执行以下操作：列出订单、查看订单详情、管理配送、处理订单取消、处理退款以及追踪该结账体验中的退货情况。由于底层电商订单基础架构将被停用，这些端点也将被弃用。

开发者应停止调用这些端点并移除相关依赖项。目前没有替代 API 可用。

典型的受影响端点包括：

GET /{commerce-order-id} - 订单详情
GET /{commerce-order-id}/items - 订单行项目
GET /{commerce-order-id}/payments - 订单支付
GET /{commerce-order-id}/payment_transaction_details - 支付交易详情
GET /{commerce-order-id}/refunds - 订单退款
GET /{commerce-order-id}/shipments - 订单配送
GET /{commerce-order-shipment-id}/items - 配送行项目
GET /{commerce-return-id} - 退货详情
GET /{commerce-order-cancellation-id}/items - 取消行项目
GET /{page-id}/commerce_orders - 按公共主页列出订单
GET /{commerce-merchant-settings-id}/commerce_orders - 按电商设置列出订单
GET /{commerce-merchant-settings-id}/commerce_returns - 按电商设置列出退货
GET /{commerce-merchant-settings-id}/tax_settings - 税务设置

47 个受影响端点的完整列表将在图谱 API v26.0 更新日志中提供。

图谱 API：Rights Manager 所有者字段已迁移至 RightsHolderOwner

AudioVisualReferenceMatch 和 ImageReferenceMatch 中的 reference_owner 和 matched_reference_owner 字段，以及 CopyrightOwnershipTransfer 中的 sending_rights_holder 和 receiving_rights_holder 字段将停用。从图谱 API v26.0 开始，返回专用 RightsHolderOwner 类型的替代字段可用于更好地表示 Rights Manager 使用的所有权模式，且 v26.0 及更高版本的响应中不再返回已停用的字段。

已停用字段将在 v26.0 发布后的两年内继续适用于 v25.0 及更早版本，之后将被移除。开发者应在这两年期限内迁移到替代字段。

使用以下替代字段：

使用 reference_owner_rh_owner 而非 reference_owner。
使用 matched_reference_owner_rh_owner 而非 matched_reference_owner。
使用 sending_rights_holder_owner 而非 sending_rights_holder。
使用 receiving_rights_holder_owner 而非 receiving_rights_holder。

典型的受影响端点包括：

GET /{audio-visual-reference-match-id} - 参考匹配详情
GET /{image-reference-match-id} - 图片参考匹配详情
GET /{copyright-ownership-transfer-id} - 所有权转移详情

完整的字段列表将在图谱 API v26.0 更新日志中提供。

图谱 API：旧版协议功能已停用

自 2026 年 7 月 29 日起，图谱 API v26.0 及更高版本不再支持五种旧版协议行为：pretty、debug、date_format、根路径 GET /?ids=... 请求，以及旧版 If-None-Match/ETag 处理机制。

这些行为将被停用，以简化图谱 API 响应，并使请求处理更一致。

对于图谱 API v26.0 及更高版本：

pretty 被忽略，且 JSON 响应使用紧凑格式。JSON 格式化需在客户端工具或代码中完成。
debug 被忽略，且不会添加任何调试响应包。请使用标准调试工具。debug_token 端点不受影响。
包含 date_format 的请求会返回参数错误。请使用默认日期格式，并在必要时在本地转换值。
使用 GET /?ids=... 的根请求会返回参数错误。请使用逐对象请求或支持的批量处理。
If-None-Match 被忽略。旧版 ETag 响应标头和 304 Not Modified 行为已移除，请求会返回完整响应。

自 2026 年 10 月 27 日起，这些变更将应用于所有其余的受支持的图谱 API 版本。查看运行时请求记录和图谱 API v26.0 更新日志，了解迁移详情。

新版公共主页体验的旧版公共主页字段已停用（图谱 API v26.0）

开发者博文草稿。目标版本：图谱 API v26.0。变更类型：停用（90 天）。

摘要

对于新版公共主页体验页面，自图谱 API v26.0 起，五个旧版公共主页节点字段 (current_location、genre、network、parking、start_info) 以及 auto_publish_page_info_updates 公共主页设置将停用。这些字段已不再维护，对于新版公共主页体验页面，不应再访问这些字段。

时间安排

2026 年 7 月 29 日：在 v26.0 及更高版本中，针对新版公共主页体验页面的相关字段已禁用，设置已移除。
发布约 90 天后：所有其余版本均会应用相同的变更。2026 年 10 月下旬的具体日期待确认。

变更内容

在 v26.0 及更高版本中，针对新版公共主页体验页面请求这五个字段中的任何一个都会返回版本错误，并且公共主页设置响应中不再显示 auto_publish_page_info_updates 设置。在更早版本中，行为保持不变，直至 90 天迁移期结束，之后所有版本都将适用相同的变更。

受影响的端点：

GET /{page-id}?fields=current_location
GET /{page-id}?fields=genre
GET /{page-id}?fields=network
GET /{page-id}?fields=parking
GET /{page-id}?fields=start_info
GET /{page-id}?fields=settings - auto_publish_page_info_updates 设置将从返回的设置列表中移除

开发者应采取的行动

请从您的公共主页请求中移除这些字段和 auto_publish_page_info_updates 设置。
查看您的请求记录、客户集成和面板，了解这些字段在新版公共主页体验页面中的使用情况。
请参阅图谱 API v26.0 更新日志，获取完整的最新列表。

参考文档

公共主页节点参考文档

市场营销 API：针对住房、就业以及金融产品和服务类广告系列的进阶赋能型受众要求

自 2026 年 7 月 29 日起，在市场营销 API v26.0 中，对于完全默认或放宽型受众设置，targeting_automation 中的 advantage_audience 参数将自动默认设为 1。对于受限的受众设置，针对属于住房、就业或金融产品和服务特殊广告类别的广告系列，开发者必须明确将 advantage_audience 设置为 1 或 0。

此行为仅在新建广告组时适用。更新现有广告组时，无论使用哪个 API 版本，都不会出现这种行为。

这与市场营销 API v23.0 中针对特殊广告类别以外的广告系列所引入的行为相同。详情请参见进阶赋能型受众疑难解答文档。

以下 API 端点将受到影响：

POST /{ad-account-id}/adsets
POST /{adset-id}
POST /{adset-id}/copies

市场营销 API：“探索”广告版位已停用

从 2026 年 7 月 29 日发布的市场营销 API v26.0 开始，Instagram 探索动态版位将不再可用。“探索”版块将停止广告投放，广告系列花费将自动转入其他符合条件的版位。

尝试创建或更新指定“探索”版位的广告组将会返回错误。开发者应从版位配置中移除“探索”版位，改用其他符合条件的版位。

以下端点会受到影响：

POST /act_{ad-account-id}/adsets
POST /{ad-set-id}

市场营销 API：针对“网站+ 应用”广告系列停用“仅限网站”目标位置

自 2026 年 7 月 29 日起，在市场营销 API v26.0 中，对于使用“网站和应用”转化发生位置的广告系列中的广告，开发者将无法再关联 applink_treatment 设为 web_only 的广告创意。这会影响通过 POST /act_{ad-account-id}/ads 和 POST /{ad-id} 进行的广告创建和更新。

广告创意端点没有变化，但 applink_treatment 值是在 POST /act_{ad-account-id}/adcreatives 中配置的。开发者应检查其集成，查看 applink_treatment=web_only 配置，并针对“网站和应用”广告系列使用自动目标位置选择或其他兼容的手动目标位置。

2026 年 10 月 27 日，即 v26.0 发布 90 天后，此限制将适用于所有市场营销 API 版本。详情请参见广告和广告创意文档。

市场营销 API：Messenger 快拍版位已停用

自 2026 年 7 月 29 日发布的市场营销 API v26.0 起，通过 v26.0 或更高版本的调用创建或更新广告组时，messenger_positions中的 story 值将不再可用。

对于这些调用，story 将从定位规范中被静默移除，且不会再显示在新建或现有广告组的有效版位中。通过 GET /{ad_set-id}?fields=targeting 请求数据时，历史定位数据可能仍会包含 story。不会返回专门针对此情况的错误，但如果移除 story 导致版位配置无效，则可能会触发标准版位验证错误。

以下端点会受到影响：

POST /act_{ad-account-id}/adsets
POST /{ad_set-id}

使用手动版位的开发者应从 messenger_positions 中移除 story。如果这是唯一值，请移除整个 messenger_positions 字段，若未使用其他 Messenger 版位（如 marketing_messages），考虑从 publisher_platforms 中移除 messenger。对于进阶赋能型版位，无需执行任何操作。

这项仅限 API 的变更不会影响广告管理工具。未指定版本的调用以及针对低于 v26.0 版本的调用最初不受影响。2026 年 10 月 27 日（v26.0 发布 90 天后），停用措施将适用于所有市场营销 API 版本，包括未指定版本的调用。

市场营销 API：调研广告创建功能已停用

从 2026 年 7 月 29 日发布的市场营销 API v26.0 开始，在创建或更新广告和广告创意时将不再支持调研组件。interactive_components_spec 下的 poll_spec 字段和 type 字段的 "poll" 值将不再可用。

创建调研创意或将广告改为使用调研创意的请求将被拒绝。对现有广告的更新如果不涉及更改创意（例如状态、预算或排期更改）则可继续进行。

以下端点会受到影响：

开发者应从其创意参数中移除调研相关的字段，改为使用不含调研组件的创意。针对低于 v26.0 版本的调用以及未指定版本的调用最初不受影响。

2026 年 10 月 27 日（即 v26.0 发布 90 天后），此停用将适用于所有市场营销 API 版本。

Meta 业务 SDK v26 版本

Meta 业务 SDK v26 版本将在图谱 API v26 发布后不久推出。该版本将包括依赖项升级、转化 API 参数构建工具集成、新的 API 功能，以及电商订单管理 API 和多项旧版协议功能的停用。

业务 SDK 现已与开源转化 API 参数构建工具集成。您可以利用这一新集成改善转化 API 集成的质量。主要功能：自动生成（受广告主偏好设置限制）并优化参数 fbc、fbp、event_source_url、referrer_url、client_ip_address，以及针对支持的语言进行自动个人身份识别信息 (PII) 标准化/散列处理，点击此处了解更多信息。电商订单管理 API（47 个端点）已完全停用，且无替代方案。Instagram 探索动态广告版位已移除，如指定此版位，将会返回错误。Messenger 快拍版位已从 messenger_positions 中静默移除。WhatsApp 动态广告新增多项功能，包括身份参数、最多 10 张图卡的轮播和站外转化优化。

根据平台 SDK 的两年停用计划，近期的停用和结束运行信息如下，敬请关注：