小组

路径 /{group-id}

代表 Workplace 小组。/{group-id} 节点会返回单个小组。

公司间合作小组

在使用公司间合作小组时，应考虑以下特定因素：

• 公司间合作小组的成员公司内安装的所有集成均能读取小组内容
• 公司间合作小组与常规小组一样被列为社群或小组

  • purpose 字段可用于识别公司间合作小组。此值将被设置为 WORK_MULTI_COMPANY
• 也可查询小组成员，但是如果应用并非来自用户所属公司，则只能看到 id、name 以及 picture
• 具有管理小组权限的集成可以添加及移除公司间合作小组成员

  • 集成可以添加及移除的用户仅限于安装了该集成的社群的成员
  • 仅当有小组管理员是安装了集成的社群的成员时，该集成才能添加及移除用户
• 如果符合以下任意一种情况，具有管理小组内容权限的集成可以删除公司间合作小组中包含的内容：

  • 内容属于某位应用社群成员；或者
  • 某位应用社群成员是小组管理员
• 目前不支持在公司间合作小组中发布内容
• 可以在集成的小组范围设置中选择公司间合作小组
• 无法在公司间合作小组中提及智能助手

读取

你可以向 /{group-id} 发送图谱 API GET 请求，了解小组相关信息。

权限

如要读取小组节点，需要拥有读取小组内容权限。

字段

发布

你无法使用此连线进行发布操作。如要创建小组，请将其发布至 /community/groups 连线。

删除

你无法使用此节点删除小组。如果移除最后一位小组成员，系统会自动删除该小组。

更新

如要更新小组，可以向 /{group-id} 发送图谱 API POST 请求，并在请求正文中传递要更新的字段值。

权限

如要更新小组节点，需要拥有管理小组权限。

连线

示例

获取小组编号、名称、归档状态以及隐私设置：

GET graph.facebook.com
  /{group-id}?fields=id,name,archived,privacy

将小组归档：

POST graph.facebook.com
  /{group-id}?archive=true

获取小组成员的名称、编号及加入日期：

GET graph.facebook.com
  /{group-id}/members?fields=name,id,joined

在单次调用中获取小组管理员和版主：

GET graph.facebook.com
  /{group-id}?fields=admins,moderators

获取小组文档：

GET graph.facebook.com
  /{group-id}/docs

获取小组帖子：

GET graph.facebook.com
  /{group-id}/feed

获取小组帖子（按最后一次更新时间排序）：

GET graph.facebook.com
  /{group-id}/feed?sorting_setting=RECENT_ACTIVITY

参数

sorting_setting

如果将该参数设置为 RECENT_ACTIVITY，则可以按照帖子最后一次更新的时间（而不是创建时间）排序。通过将 CHRONOLOGICAL 用作值，可以明确设置默认行为。更新可能包括编辑帖子以及添加评论或心情。

获取包含视频、图片、文件或投票等额外附件的小组帖子：

GET graph.facebook.com
  /{group-id}/feed?fields=attachments

获取小组成员（包含其加入日期）清单：

GET graph.facebook.com
  /{group-id}/members?fields=name,joined

通过编号添加小组成员：

POST graph.facebook.com
  /{group-id}/members/{member-id}

通过邮箱添加小组成员：

POST graph.facebook.com
  /{group-id}/members?email=michael%40example.com

通过编号移除小组成员：

DELETE graph.facebook.com
  /{group-id}/members/{member-id}

通过邮箱移除小组成员：

DELETE graph.facebook.com
  /{group-id}/members?email=michael%40example.com

将成员升级为小组管理员：

POST graph.facebook.com
  /{group-id}/admins/{user-id}

将小组管理员降级为成员：

DELETE graph.facebook.com
  /{group-id}/admins/{user-id}

创建新的小组事件：

POST graph.facebook.com
  /{group-id}/events
  ?name=New+Event
  &start_time=2017-03-02T14:00:04+00:00
  &end_time=2017-03-02T15:00:04+00:00
  &description=Test+Description
  &location=Boardroom

在小组中上传（以二进制方式）新的相片：

POST graph.facebook.com
  /{group-id}/photos?source={image-data}

在小组中上传（通过网址）新的相片：

POST graph.facebook.com
  /{group-id}/photos?url={image-data}

创建包含图片或视频附件的小组帖子：

POST graph.facebook.com
  /{group-id}/feed?attached_media=[{"media_fbid":"{photo-id}"},{"media_fbid":"{photo-id}"}]

参数

attached_media

适用于图片和视频，包含被大括号括起的 media_fbids 数组。支持以下图片格式：.jpeg、.bmp、.png、.gif、.tiff。如需获取有关图片格式的更多信息，请点击此处。如需了解支持的视频文件，请点击此处。如要获取图片的 media_fbids，请先将未经发布的图片发布至 https://graph.facebook.com/me/photos（如此处文档所述）。如要获取视频（包括 GIF 动画）的 media_fbids，请先将视频发布至 https://graph.facebook.com/me/videos?no_story=true。

创建包含文件附件的小组帖子：

POST graph.facebook.com
  /{group-id}/feed?files=[{file-id},{file-id}]

参数

files

适用于文件，包含 file_ids 数组（请注意，该数组并未被大括号括起）。目前不支持文件版本管理。如要更新文件，请将原始文件从帖子附件中移除，然后重新上传新的文件附件。支持以下文件格式：

• 文档：.pdf、.csv、.tsv、.docx、.pptx、.xlsx
• 图片：.jpeg、.png
• 视频：.mp4
• 存档：.rar、.zip

如要获取 file_ids，请先将文件发布至 https://graph.facebook.com/group_file_revisions。你可以在本地发布来自你的电脑的源文件。

更新帖子权限、加入设置、用途以及帖子审核设置

POST graph.facebook.com
  /{group-id}/?post_permissions=NONE&join_setting=ADMIN_ONLY&purpose=WORK_SOCIAL&post_requires_admin_approval=false

获取针对置顶帖子的心情及评论

GET graph.facebook.com
  /{group-id}/pinned_posts?fields=reactions,comments

识别小组是否也是社群

GET graph.facebook.com
  /{group-id}?fields=is_community

获取小组的自动成员加入规则

GET graph.facebook.com
  /{group-id}/auto_membership_rules

响应示例 (JSON)：

{
  "data": [
    {
      "conditions": [
        {
          "field": "TITLE",
          "operator": "CONTAINS",
          "values": [
            "sales"
          ]
        }
      ],
      "id": RULE_ID
    }
  ],
  ...
}

删除小组的自动成员加入规则

DELETE graph.facebook.com
  /RULE_ID

为小组应用自动成员加入规则

POST graph.facebook.com
  /{group-id}/auto_membership_rules

Payload 示例：

{
    "conditions": [
        {
            "field": "LOCATION",
            "operator": "CONTAINS",
            "values": ["London", "San Francisco"]
        }
    ]
  }

获取小组编号和官方小组状态：

GET graph.facebook.com
  /{group-id}?fields=id,is_official_group

更新官方小组状态：

POST graph.facebook.com
  /{group-id?is_official_group={FALSE | TRUE}