授权

要访问市场营销 API 端点,您的应用必须获得图谱 API 多个层级的授权。

层级 1:应用类型

当您创建 Facebook 应用时,系统会询问您该应用的使用方式。您的选择将决定应用的类型:业务游戏无类型。请查看应用类型

要访问市场营销 API 端点,您需要创建业务应用。请查看业务应用下的可用产品

注册应用后,您可以向拥有开发者账户的所有人分配身份,在开发过程中获取他们的帮助。

层级 2:访问级别、权限和功能

公司应用受额外一层图谱 API 授权的制约(称为访问级别)。在应用审核期间,您的应用还必须请求特定的权限和功能。

功能访问级别

功能访问级别描述

标准访问级别

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


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


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

高级访问级别

如果应用需要获准使用高级访问级别,则需通过针对每个权限和功能进行的应用审核流程。


如要请求高级访问级别,请前往应用面板,然后点击应用审核 > 权限和功能


找到要访问的权限或功能,然后点击操作下方的申请高级访问级别。您可选择一项或多项功能。选择所需功能后,点击继续请求,之后您将前往另一页面,并按照此页面的指导完成整个提交流程。


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


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

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

每个级别均有相应的限制,请参阅访问级别及功能。此外,所有开发者都必须遵守所有 Facebook 开放平台条款开发者政策无论请求哪种级别的访问权限,均是针对生产数据而言。

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

广告 API 权限与广告管理标准权限的对照

市场营销 API 权限广告管理标准权限操作

开发权限

标准权限

默认

标准访问级别

高级访问级别

需要在应用面板上申请

权限和功能

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

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

您需要请求的功能取决于您的 API 使用方式。如果您要管理广告,需请求的其中一项常用功能便是 Ads Management Standard Access。请查看适用于业务应用的所有可用功能

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

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

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

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

填写 YOUR_URL 字段时,请在末尾输入一个 /。示例:http://www.facebook.com/

示例

用例请求内容

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

  • 权限:ads_management
  • 功能:Ads Management Standard Access

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

  • 权限:ads_read
  • 功能:Ads Management Standard Access

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

  • 权限:ads_managementads_read
  • 功能:Ads Management Standard Access

访问级别和功能

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

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

账户限制

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

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

流量限制

各广告账户的流量限制非常严格。仅用于开发,不适用于现有广告主正在运行的已投产应用。

各广告账户的流量限制程度较轻。

商务管理平台

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

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

系统用户

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

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

公共主页创建

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

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

访问权限与广告管理标准权限的对比情况

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

层级 3:公司验证

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