Руководства

Это руководство содержит информацию о стандартном использовании API Groups.

Получение публикаций для группы

Чтобы получить публикации группы, выполните запрос GET к границе контекста /{group-id}/feed.

По умолчанию в ответы не включаются персональные данные, позволяющие установить личность. Чтобы в ответ включалась общедоступная информация об авторе публикации, автор должен предоставить приложению разрешение 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 дней.

Просмотр списка пользователей, которые поделились информацией о себе

Чтобы просмотреть список участников группы, которые предоставили вашему приложению разрешение groups_access_member_info, выполните запрос GET к границе контекста /{group-id}/opted_in_members. В результате вы получите список пользователей группы, которые решили поделиться своей общедоступной информацией с установленными в группе приложениями.

Пример запроса

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 для групп, участники которых устанавливают или удаляют ваше приложение

Вы можете подписаться на поле group_install в объекте Application, чтобы получать уведомление webhook каждый раз, когда участник группы устанавливает или удаляет приложение в группе.

Образец уведомления

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