FB商务管理平台(Business Manager) （2）

Business Manager 商务管理平台（以下简称BM）API 

    一站式管理广告帐户、主页及相关的工作人员。

BM功能结构（其中：账户下的节点属于市场营销API）

API / SDK

 FB提供了多种语言的SDK， SDK列表  

当然，如果你使用了其他的语言来实现的api，那也可以通过curl模拟抓取 实现封装自己的SDK.

 

API 采用rest风格，比如要访问某BM账户下的员工，那url应该是：

　　GET https://graph.facebook.com/<API_VERSION>/<business_id>/business_users

 

API接口路径规则

　　Host：https://graph.facebook.com/

　　+v<API_VERSION>/ (v必须有 如：v3.2)

　　+<根节点>/

　　+<节点>/...

所有接口均需附上token(GET/POST)： access_token=<ACCESS_TOKEN>

 

比较重要的几个节点 

• 　　/me  (特殊节点，代表当前API用户)
• 　　/<BUSINESS_ID> （当获取到BM ID后，BM下资产等均通过此节点获取）

 

获取和“我”相关的BM列表

/me/businesses

/me/business_users　　//获取我在其他BM下的用户信息 附:fields=role 可查看权限

 <BUSINESS_ID>节点下内容

获取BM下用户列表

1. <BUSINESS_ID>/business_users //获取所有员工(管理员和员工)

2. <BUSINESS_ID>/system_users   //获取系统用户(虚拟用户)

3. <BUSINESS_ID>/pending_users  //获取邀请但还未接受的用户

BM资产管理

　　主页

1. • <BUSINESS_ID>/owned_pages    //自有
   • <BUSINESS_ID>/client_pages     //代理
   • <BUSINESS_ID>/pending_owned_pages   //审核中的自有主页
   • <BUSINESS_ID>/pending_client_pages     //审核中的代理主页

　　应用

• •  <BUSINESS_ID>/(owned_apps | client_apps | pending_client_apps)

 

　　广告账户 字段参考文档

• • <BUSINESS_ID>/(owned_ad_accounts | client_ad_accounts | pending_owned_ad_accounts | pending_client_ad_accounts) 

 

 相互关联接口

//BM用户可管理的主页（此处的id是用户在BM下的员工/系统用户ID）
<BUSINESS_SCOPED_USER_ID>/assigned_pages
"tasks": [
        "ANALYZE", #只读
        "ADVERTISE"#可操作
      ]

//哪些用户可管理此主页
<PAGE_ID>/assigned_users?business=<business_id>

//用户可管理的账户 （实测：若使用应用的开发者登录，且开发者有广告账户未在此BM下会报错，请使用 /me/adaccounts 获取账户）
<BUSINESS_SCOPED_USER_ID>/assigned_ad_accounts

//哪些用户可管理此账户（act_ 必须有）
act_<AD_ACCOUNT_ID>/assigned_users?business=<BUSINESS_ID>

//账户可投放的应用列表(FB会结合api上下文返回所有可投放的应用)
act_<AD_ACCOUNT_ID>/advertisable_applications

 

接口结构