指南

本指南介绍了小组 API 的常见用途。

获取小组的帖子

您可对 /{group-id}/feed 连线执行 GET 操作来获取小组中的帖子。

默认情况下，个人身份信息不包含在此响应中。如要让响应包含帖子作者的公开信息，帖子作者必须向您的应用授予 groups_access_member_info 权限。

请求示例

curl -i -X GET \ 
  "https://graph.facebook.com/{group-id}/feed?limit=5&access_token=EAACEdEos0..."

响应示例

系统将省略含有个人身份信息的响应示例。

{
  "data": [
    {
      "message": "I love this group!",
      "updated_time": "2018-06-28T23:31:49+0000",
      "id": "554611227955614_1708186035931455"  //Post ID
    },
    {
      "message": "I like how linked groups look on mobile!",
      "updated_time": "2018-06-14T23:19:02+0000",
      "id": "554611227955614_1687969857953073"  //Post ID
    }
  ]
}

响应示例

响应示例：发帖人授予您的应用 groups_access_member_info 权限。

{
  "data": [
    {
      "from": {
        "name": "Himanshu Sharma",
        "id": "512130107215"
      },
      "message": "I love this group!",
      "id": "554611227955614_1708186035931455"
    },
    {
      "from": {
        "name": "Ronak Patel",
        "id": "512130107214"
      },
      "message": "Just testing how linked groups look like on mobile!",
      "id": "554611227955614_1687969857953073"
    }
  ]
}

限制

• 调用仅返回过去 90 天内创建的帖子的数据。

获取共享公开字段的用户

您可对 /{group-id}/opted_in_members 连线执行 GET 操作，以获取已授予您应用 groups_access_member_info 权限的小组成员用户列表。这些小组成员已选择向小组上安装的应用共享其公开信息。

请求示例

curl -i -X GET \ 
  "https://graph.facebook.com/{group-id}/opted_in_members&access_token=EAACEdEos0..."

响应示例

{
  "data": [
    {
      "name": "Himanshu Sharma",
      "id": "510765591715"
    },
    {
      "name": "Ronak Patel",
      "id": "410662391314"
    }
  ]
}

获取安装/卸载您应用的小组的 Webhooks

您可订阅 Application 对象上的 group_install 字段，从而在小组成员于小组中安装或卸载您的应用时接收 Webhooks 通知。

通知示例

{
  "field": "group_install",
  "value": {
    "group_id": "954704787945183",
    "update_time": "1527459824",
    "verb": "add",
    "actor_id": "499619301"
  }
}