授权

授权流程验证将访问市场营销 API 的用户和应用,并向其授予权限。

应用身份

在应用面板中,您可以根据需要为自己或团队成员设置身份:管理员、开发者、测试者。

注意:根据预期用例,您可能需要提交应用进行审核,才能获得与广告管理相关的特定权限。

访问级别、权限和功能

业务应用需要进行额外一层图谱 API 授权,称为访问级别。在应用审核期间,您的应用还必��请求特定的权限和功能。

每个级别均有相应的限制,详情请参阅访问级别及功能。此外,所有开发者都必须遵守所有 Meta 开放平台条款开发者政策对任何访问级别的调用均是针对生产数据而言。

市场营销 API 访问级别与广告管理标准访问级别的对照

应用的权限和功能有两种不同的访问级别:标准访问权限和高级访问权限(注意:此处使用的“标准访问权限”一词与广告管理标准访问级别功能无关。)广告管理标准访问级别中的高级访问级别仍然需要应用通过审核才能获得此功能。

市场营销 API 访问权限与广告管理标准访问级别的对照

市场营销 API 访问权限广告管理标准访问级别操作

开发权限

标准访问级别

默认

标准访问级别

高级访问级别

在应用面板中申请

如要查看您当前的访问级别,请前往应用面板 > 应用审核 > 权限和功能

权限和功能

权限

您需要请求的权限取决于您想要访问的 API。

如果您的应用仅用于管理您的广告账户,拥有 ads_readads_management 权限的标准访问级别就已足够。如果您的应用要管理其他用户的广告账户,则您需要 ads_read 和/或 ads_management 权限的高级访问级别。请查看适用于业务应用的所有可用权限

功能

您需要请求的功能取决于您的 API 使用方式。如果您要管理广告,一个要请求的常见功能是广告管理标准访问级别。请查看适用于业务应用的所有可用功能

功能访问级别
功能访问级别描述

标准访问级别

业务应用会自动获准使用适用于业务应用类型的所有权限和功能的标准访问级别。

如果您是新手,则使用此选项。您可以在请求完整权限之前构建端到端工作流程,并且可以访问不限数量的广告账户。

有些 API 调用可能属于多个账户,或者系统无法通过程序识别哪些账户会受到这些调用的影响,因此您可能无法借助标准访问级别执行这些调用。

高级访问级别

如要使用单个权限和功能的高级访问级别,必须通过应用审核流程来获得批准。

  1. 如要请求高级访问级别,请前往应用面板,然后点击应用审核 > 权限和功能
  2. 找到要访问的权限或功能,然后点击操作下方的申请高级访问级别。您可选择一项或多项功能。选好选项后,点击继续请求。您将跳转到一个屏幕,该屏幕将指导您完成提交流程。

您提交信息后,Meta 会回复批准或拒绝;如果您的应用不符合使用标准访问级别的资格要求,Meta 还会提供相关信息。

如果您已获准使用高级访问级别,需完成以下操作,才能维持您的状态:

  • 在最近 15 天内,至少成功调用了 1,500 次市场营销 API。
  • 在最近 15 天内,市场营销 API 的调用出错率低于 10%。
访问级别的重要性

下表展示了标准访问级别和高级访问级别对广告管理标准访问级别功能的影响。

标准访问级别 高级访问级别

账户限制

可管理不限数量的广告账户。应用管理员或开发者可以代表广告账户管理员或广告主发出 API 调用。

假如您从广告账户处获取了 ads_readads_management 权限,便可管理不限数量的广告账户。

流量限制

各广告帐户的流量限制非常严格。仅用于开发,不适用于为实际广告主投放广告的生产应用。

每个广告账户受到的流量限制程度较轻。

商务管理平台

商务管理平台目录 API 的访问权限有限。无权通过商务管理平台管理广告账户、用户权限和公共主页。

有权访问所有商务管理平台目录 API。

系统用户

可以创建 1 个系统用户和 1 个管理员级系统用户。

可以创建 10 个系统用户和 1 个管理员级系统用户。

公共主页创建

无法通过此 API 创建公共主页。

无法通过此 API 创建公共主页。

获取高级访问权

如要获得广告管理标准访问权功能的高级访问级别,您的应用需要满足以下要求:

  • 在最近 15 天内,至少成功调用了 1,500 次市场营销 API。
  • 在最近 15 天内,市场营销 API 的调用出错率低于 10%。

如果您要管理其他用户的广告,请使用 scope 参数提醒用户授予 ads_managementads_read 权限。在用户点击允许后,您的应用将获得相应权限。

https://www.facebook.com/v22.0/dialog/oauth? client_id=<YOUR_APP_ID> &redirect_uri=<YOUR_URL> &scope=ads_management

注意:输入 YOUR_URL 字段时,请在末尾添加一个 /(例如 http://www.facebook.com/)。

用例示例
用例请求内容

想要读取并管理归自己广告账户的广告,或广告账户所有者授权您访问的广告账户的广告。

  • 权限:ads_management
  • 功能:广告管理标准访问级别

想要读取自己广告账户的广告报告,或广告账户所有者授权您访问的广告账户的广告报告。

  • 权限:ads_read
  • 功能:广告管理标准访问级别

想要提取一组客户的广告报告,并读取及管理另一组客户的广告。

  • 权限:ads_managementads_read
  • 功能:广告管理标准访问权

公司验证

我们会通过公司验证流程来验证您的公司实体身份,当您的应用要访问敏感数据时,我们会要求您进行此项验证。详细了解公司验证流程。