资产管理概览

企业可以访问多种资产。这些资产包括您企业拥有的资产，也包括您企业作为代理商有权访问的资产。您可以使用 Facebook 的业务资产管理 API 添加、移除或查询企业与其资产的关系，同时管理业务资产及其访问权限。

代理商是指可管理或访问另一个企业所拥有资产的企业实体。通过这种关系，代理商可以代表客户执行特定任务或操作，例如管理广告账户、公共主页或其他数字资产。

业务资产组

业务资产组有助于大型广告主或代理商高效地管理企业中的用户和资产。您应该以与实际业务对应的方式来组织资产和用户。例如，企业可以根据品牌、地区、客户或其自行选择的组织原则来组织其资产和用户。

业务资产组可以包含广告账户、公共主页、Facebook Pixel 像素代码、线下事件集、应用、目录、自定义转化事件和 Instagram 账户。这些资产可以由企业所有，也可以进行分享，以便向代理商授予资产的访问权限。

您可以使用此 API 将用户添加到业务资产组中。添加用户后，您就可以向其授予业务资产组中资产的权限。这有助于您同时授予多项资产的访问权限，而无需在企业层级创建过多的管理员。

借助此 API，您可以管理某个企业已通过商务管理平台创建的业务资产组，也可以管理业务资产组中的资产。您可以执行以下操作：

获取与某个企业关联的业务资产组清单
删除某个业务资产组或为其重命名
查看某个业务资产组中的所有资产
获取、添加、编辑和删除用户对于业务资产组中资产的权限
将用户分配到业务资产组
获取业务资产组中的资产、向业务资产组添加资产以及从业务资产组中删除资产

权限

如要使用业务资产组 API，您的应用需要具备适当的市场营销 API 访问级别：

对于所有添加和移除端点：访问口令所属的用户必须是企业的管理员。否则，访问将被拒绝。
对于所有 API 端点：您的应用需要具备 business_management 权限。

对于以下端点，您的应用还需要具备其他权限：

业务资产组端点	需要的权限
获取广告账户清单	`ads_management`
获取商品目录清单、添加商品目录或移除商品目录	`ads_management`
获取 Instagram 账户清单、添加 Instagram 账户或移除 Instagram 账户	`ads_management`。如果使用市场营销 API v4.0，您还需要具备 `instagram_basic`。
获取 Pixel 像素代码清单	`ads_read`
获取线下事件集清单	`ads_management`
获取自定义转化事件清单	`ads_read`
添加自定义转化事件	`ads_management`

限制

如果您尝试通过以下 API 调用来减少或移除业务资产组中某个资产的权限，您会看到一条错误消息：

向 /{page_id}/assigned_users 发送的 DELETE 请求
向 /{page_id}/assigned_users 发送的 POST 请求
向 /act_{ad_account_id}/assigned_users 发送的 DELETE 请求
向 /act_{ad_account_id}/assigned_users 发送的 POST 请求。

如要减少或移除权限，请按以下步骤操作：

执行调用，以获取与某个企业关联的资产组清单。查找 contained_asset_id 与 {page_id} 或 {ad_account_id} 相同的资产组。
针对每个返回的业务资产组编号，执行 API 调用，以从该资产组中移除某个用户。
然后，执行上述 DELETE 或 POST 请求，以移除该用户在公共主页或广告账户上的权限。

如果您在应用中为其他企业提供权限管理功能，应使用此 API，以免此 API 与商务管理平台之间出现不一致和错误。

您无法通过业务资产组来设置应用、目录、Instagram 账户和自定义转化事件上的权限。您应该改为在资产层级分配权限。

例如，如果您将 Roger 添加到 Jasper 的商务管理平台中的某个业务资产组，Roger 将可以获得该业务资产组中任何公共主页、广告账户、Pixel 像素代码等资产的权限。但是，如要删除或编辑 Roger 对 Jasper 的业务资产组中任何资产所具有的权限，您必须在业务资产组中进行操作。

您可以使用资产 API 在资产层级添加用户权限，例如将某个用户从公共主页版主更改为管理员。请参阅公共主页和广告账户的示例。

业务资产组已于 2019 年 10 月 13 日取代了项目 API。您应该将项目 API 上的所有应用都迁移到业务资产组。

允许的身份

向商务管理平台添加用户时，可通过业务用户 API 分配以下两个身份之一：

API 常量	名称	描述
`ADMIN`	企业管理员	可以控制企业设置的方方面面，包括修改或删除账户以及添加或移除用户。
`EMPLOYEE`	企业工作人员	可以查看企业设置中的所有信息，但无法做出任何更改（除非在向企业添加的公共主页或广告账户中，此用户是管理员）。

API 常量	名称	描述
`['MANAGE', 'ADVERTISE']`	目录管理员	具有该目录的完全读取和写入权限，可以管理该目录的方方面面，包括：创建、更新、删除商品；管理信息库；将目录附加到 Pixel 像素代码和应用；创建商品系列；使用该目录投放进阶赋能型目录广告；更改目录设置等等。
`['ADVERTISE']`	目录广告主	可以创建商品系列，并使用该目录投放进阶赋能型目录广告。无法编辑其商品、信息库或目录设置。

广告账户

对于该企业可访问的广告账户，可使用广告账户 API 向该企业中的任何用户分配以下身份：

API 常量	名称	描述
`['MANAGE', 'ADVERTISE', 'ANALYZE']`	广告账户管理员	可以管理广告系列的方方面面，包括报告、账单和账户权限，并且可以设置广告账户花费限额。广告账户管理员也可以关联业务账户支付方式。
`['ADVERTISE', 'ANALYZE']`	广告账户广告主	可以查看和编辑广告，并使用与广告账户关联的支付方式来创建广告。
`['ANALYZE']`	广告账户分析员	可以查看广告表现。

公共主页

对于该企业可访问的公共主页，可使用公共主页 API 向该企业中的任何用户分配以下身份：

API 常量	名称	描述
`['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	公共主页管理员	可以管理公共主页身份、以公共主页身份发送消息和发布帖子、创建广告以及查看成效分析。
`['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	公共主页编辑	可以编辑公共主页、以公共主页身份发送消息和发布帖子、创建广告以及查看成效分析。
`['MODERATE', 'ADVERTISE', 'ANALYZE']`	公共主页版主	可以回复和删除公共主页上的评论、以公共主页身份发送消息、创建广告以及查看成效分析。无法以公共主页身份发布帖子。
`['ADVERTISE', 'ANALYZE']`	公共主页广告主	可以为公共主页创建广告以及查看成效分析。无法以公共主页身份发布帖子。
`['ANALYZE']`	公共主页分析员	可以查看成效分析。无法以公共主页身份发布帖子。

应用

商务管理平台中没有适用于应用的身份或任务管理 API。

Instagram 账户

商务管理平台中没有适用于 Instagram 账户的身份或任务管理 API。如果用户有权访问与 Instagram 账户绑定的广告账户，则该用户可以为这些 Instagram 账户投放广告。