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资产管理

  主页

    • <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

 

接口结构

 

posted @ 2019-04-26 22:29  寻觅~~  阅读(2332)  评论(0编辑  收藏  举报