Version API du graphe

Groupe

Un groupe Facebook.

Affichage

Renvoie des informations relatives à un seul objet de Groupe. Pour obtenir une liste de Groupes gérés par un Utilisateur, utilisez plutôt l’arête /user/groups.

Explorateur de l’API Graph
GET /v21.0/{group-id} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{group-id}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "/{group-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{group-id}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{group-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Autorisations

  • groups_access_member_info : permet à votre app de recevoir des données relatives aux membres dans du contenu de groupe.
  • publish_to_groups : permet à votre app de publier du contenu dans un groupe au nom d’un utilisateur.

Pour les groupes Fermé ou Public

Token d’accès utilisateur

Pour les Groupes secrets

Token d’accès utilisateur pour une admin du Groupe

Avertissements

  • Les champs contenant des informations Utilisateur ne sont pas inclus dans les réponses, à moins que la demande soit faite avec le token d’accès d’un admin du groupe.

Champs

Nom de propriété Description Type

id

ID de groupe

string

cover

Informations sur la photo de couverture du groupe

CoverPhoto

id

ID de la Photo associée à cette photo de couverture.

string

source

URL d’accès à la Photo associée à cette photo de couverture.

string

offset_y

Le décalage vertical de la photo par rapport au bas, en nombre de pixels.

int

offset_x

Le décalage vertical de la photo par rapport à la partie gauche, en nombre de pixels.

int

description

Une brève description du groupe.

string

email

Adresse e-mail permettant de charger du contenu dans le groupe. Seuls les membres actuels du groupe peuvent l’utiliser.

string

icon

L’URL de l’icône de groupe.

string

member_count

Nombre de membres du groupe.

int

member_request_count

Nombre de demandes de membre en attente. Exige un token d’accès d’un admin du groupe. Le nombre est communiqué uniquement lorsque plus de 50 demandes de membre sont en attente.

int

name

Nom du groupe.

string

owner

Non disponible à compter de la version 9.0. Non disponible dans toutes les versions à partir du 9 février 2021.

User | Page

parent

Parent de ce groupe, le cas échéant.

Group | Page

permissions

Les autorisations attribuées par un utilisateur pour une app installée dans le groupe.

string

privacy

Le paramètre de confidentialité du groupe. Vous pouvez spécifier plusieurs valeurs, notamment CLOSED, OPEN et SECRET. Nécessite désormais un token d’accès d’Admin du groupe.

string

updated_time

La dernière fois que le groupe a été mis à jour (avec propriétés de changement de groupe, publications et commentaires). Nécessite désormais un token d’accès d’Admin du groupe.

datetime

Création

Cette opération n’est pas prise en charge.

Mise à jour

Cette opération n’est pas prise en charge.

Suppression

Cette opération n’est pas prise en charge.

Arêtes

Nom Description

/admins

Cette arête a été abandonnée le 4 avril 2018.

/albums

Albums photo appartenant au groupe.

/docs

Documents appartenant au groupe.

/events

Évènements appartenant au groupe.

/feed

Fil de publications appartenant au groupe.

/files

Fichiers appartenant au groupe.

/live_videos

Vidéos en direct appartenant au groupe.

/members

Cette arête a été abandonnée le 4 avril 2018.

/photos

Photos appartenant au groupe.

/videos

Vidéo appartenant au Groupe.