Workplace

Workplace from Meta 即将停用。您可以继续使用 Workplace，直到 2025 年 8 月 31 日为止。详情请访问我们的帮助中心。

社群

路径 /community

替代路径 /company

代表 Workplace 社群。/community 节点（或 /company，可互换使用）会返回小组类型的单一社群对象。为方便使用 API，您可以将根社群对象视为其他小组或社群的根小组。

您可以通过向 graph.facebook.com/community 发出图谱 API GET 调用，并加入自定义集成访问口令，以搜寻社群编号。

在某些情况下，根社群也可以包含其他社群，这些社群会出现在根社群的 /groups 连线中。可以通过 is_community 字段区分子群组和根社群的子社群。

如果根社群中存在一个或多个社群，则表示此 Workplace 实例启用了社群功能。

可以依次在 /groups 连线查询这些子社群以获取该社群内的群组。在任何情况下，/groups 连线仅显示该社群的直属群组，不会执行递归。

您无法通过 API 创建社群，但可以像管理群成员一样管理社群成员。

读取

GET graph.facebook.com
  /community

权限

社群节点需要读取小组内容或管理小组权限。

发布

您无法发布使用此节点的 Workplace 社群。

删除

您无法删除使用此节点的 Workplace 社群。

更新

您无法更新使用此节点的 Workplace 社群。

连线

名称描述

/accounts

使用此连线创建、停用或删除 Workplace 社群中的账户。此连线需要预配用户账户权限

/admins

Workplace 社群的系统管理员。此连线需要管理账户权限

/badges

可用徽章清单

/events

Workplace 社群的活动。

/former_members

Workplace 社群之前的成员，其账户现已停用。

/groups

Workplace 社群中的小组和子社群。

/knowledge_library_categories

根级别类别清单

/knowledge_quick_links

资料库中常用工具和其他资源的链接清单

/members

Workplace 社群的成员。可筛选使用 external_ids 参数的用户外部编号

/reported_content

供社群管理员审核的被举报内容项目清单。请注意，此连线已于 2019 年 4 月 30 日停用。

/skills

可添加到此社群中成员的个人主页的技能清单。

示例

新建小组

您可以通过向 /community/groups 连线发出 POST 请求，为 Workplace 社群新建小组。响应将包含新创建的小组的编号。请注意，为了让小组显示所有成员，您必须添加至少一位成员，并将该成员设置为管理员。

POST graph.facebook.com
  /community/groups?
    name={...}&
    description={...}&
    privacy=OPEN

如要获取某个根社群中所有小组和社群的清单，请发送以下请求：

GET graph.facebook.com
  /community/groups?fields=is_community

如要获取某个根社群中所有成员的清单，请发送以下请求：

GET graph.facebook.com
  /community/members

如要获取某个根社群中所有成员的清单，并通过 external_id 进行筛选，请发送以下请求：

GET /community/members?
  external_ids=12356,abc123

如要举报内容项目（请注意，此连线已于 2019 年 4 月 30 日停用），请发送以下请求：

POST graph.facebook.com
  /community/reported_content?
    content_id={...}

如要向根社群新增一个小组，请发送以下请求：

POST graph.facebook.com
  /community/groups?
    name={...}&
    description={...}&
    privacy=OPEN

如要向非根社群新增一个小组，请发送以下请求：

POST graph.facebook.com
  /{community-id}/groups?
    name={...}&
    description={...}&
    privacy=OPEN

如要预配账户，请发送以下请求：

POST graph.facebook.com
  /community/accounts?
    name={...}&
    email={...}&
    department={...}&
    division={...}&
    organization={...}&
    title={...}&
    manager={...}&
    hire_date={...}&
    invite={...}&
    active={...}

如要更新账户，您需要拥有管理工作档案权限，并应使用以下端点

POST /{member-id}

如需更多信息，请前往账户管理页面。

如要获取可用徽章的清单，请发送以下请求：

此操作需要管理徽章权限

GET graph.facebook.com
  /community/badges?fields=id,name,description,icon,category

如要获取根级别类别的清单，请发送以下请求：

此操作需要读取资料库内容权限

GET graph.facebook.com
  /community/knowledge_library_categories

如要发布新的根级别类别，请发送以下请求：

此操作需要管理资料库内容权限。如需进一步了解适用于各个字段的值，请参阅此文档。

POST graph.facebook.com
  /community/knowledge_library_categories?
  title={...}&
  icon={...}&
  color={...}&
  json_content={...}

如需获取资料库中常用工具和其他资源的链接清单，请发送以下请求：

此操作需要读取资料库内容权限

GET graph.facebook.com
        /community/knowledge_quick_links?fields=title,link

如要读取资料库中的特定快捷链接，请发送以下请求：

此操作需要读取资料库内容权限

GET graph.facebook.com
        /{quick_link_id}?fields=title,link

如要在资料库中新增快捷链接，请发送以下请求：

此操作需要管理资料库内容权限

POST graph.facebook.com
        /community/knowledge_quick_links?
        title={...}&
        link={...}

如要更新资料库中的特定快捷链接，请发送以下请求：

此操作需要管理资料库内容权限

POST graph.facebook.com
        /{quick_link_id}?
        title={...}&
        link={...}

如要删除资料库中的特定快捷链接，请发送以下请求：

此操作需要管理资料库内容权限

DELETE graph.facebook.com
        /{quick_link_id}