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下用户列表
<BUSINESS_ID>/business_users //获取所有员工(管理员和员工)
<BUSINESS_ID>/system_users //获取系统用户(虚拟用户)
<BUSINESS_ID>/pending_users //获取邀请但还未接受的用户
BM资产管理
主页
- <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