Guides

Ce guide décrit les utilisations courantes de l’API Groupes.

Obtenir des publications pour un groupe

Vous pouvez effectuer une opération GET sur l’arête /{group-id}/feed pour obtenir les publications sur un groupe.

Par défaut, les informations personnellement identifiables ne sont pas incluses dans la réponse. Pour que les informations accessibles au public de l’auteur·trice de la publication soient incluses dans la réponse, celui-ci ou celle-ci doit accorder l’autorisation groups_access_member_info à votre application.

Exemple de requête

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

Exemple de réponse

Exemple de réponse dans laquelle les informations personnellement identifiables sont omises.

{
  "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
    }
  ]
}

Exemple de réponse

Exemple de réponse dans laquelle l’auteur·trice de la publication a accordé l’autorisation groups_access_member_info à votre application.

{
  "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"
    }
  ]
}

Limites

• Les appels renverront uniquement les données des publications créées au cours de 90 derniers jours.

Obtenir les utilisateur·trices partageant des champs publics

Vous pouvez effectuer une opération GET sur l’arête /{group-id}/opted_in_members pour obtenir la liste des membres du groupe qui ont accordé l’autorisation groups_access_member_info à votre application. Il s’agit des membres du groupe qui ont choisi de partager leurs informations accessibles au public avec des applications installées sur le groupe.

Exemple de requête

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

Exemple de réponse

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

Obtenir les webhooks pour les groupes qui installent/désinstallent votre application

Vous pouvez vous abonner au champ group_install de l’objet Application afin de recevoir une notification du webhook lorsqu’un·e membre du groupe installe ou désinstalle votre application sur un groupe.

Exemple de notification

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