Référence

Membre

Chemin /{member-id}

Représente un objet Utilisateur comme un membre d’une communauté ou d’un groupe Workplace.

Lecture

Renvoie un seul objet Utilisateur représentant un utilisateur de Workplace. Pour y accéder, utilisez l’ID Workplace du membre ou l’adresse e-mail qu’il utilise pour se connecter à Workplace.

  • /{member_id}
  • /{email_address}

Autorisations

Pour consulter les informations d’un membre, vous devez disposer de l’une des autorisations suivantes : Lire tous les contenus ou Gérer les comptes.

Champs

Nom du champDescriptionType

id

ID du compte utilisateur de cette personne.

string

first_name

Prénom de la personne.

string

last_name

Nom de famille de la personne.

string

email

Adresse e-mail principale de la personne, également utilisée comme nom d’utilisateur dans Workplace.

string

title

Intitulé du poste de la personne dans Workplace.

string

department

Nom du service de la personne dans Workplace, s’il est configuré via l’API Account Management.

string

employee_number

Identifiant numérique ou alphanumérique attribué à une personne, généralement basé sur l’ordre d’embauche ou d’association à une organisation.

string

primary_phone

Numéro de téléphone principal de la personne. Lié à l’entrée phoneNumbers définie comme primary dans l’API Account Management.

string

primary_address

Adresse principale de la personne. Liée à l’entrée addresses définie comme primary dans l’API Account Management.

string

picture

Image de profil de la personne.

url

link

Lien vers le profil de la personne.

url

locale

Paramètres régionaux de la personne.

string

name

Nom complet de la personne.

string

name_format

Nom de la personne formaté de sorte à respecter l’ordre en chinois, japonais ou coréen.

string

account_invite_time

Heure de l’invitation à créer un compte au format UTC.

datetime

account_claim_time

Heure de réclamation du compte au format UTC.

datetime

impersonate_token

Token d’accès de membre qui permet à une intégration d’effectuer des appels au nom d’une personne donnée. Nécessite une autorisation d’usurpation d’identité.

Cette autorisation est obsolète. Ne créez pas de nouvelle fonctionnalité reposant sur cette autorisation. Vous ne pouvez plus ajouter cette autorisation aux intégrations personnalisées.

string

about

Le contenu du champ Bio dans le profil de l’utilisateur.

string

frontline

Informations relatives au statut sur le terrain de l’utilisateur.

object (voir l’exemple ci-dessous)

Publication

Aucune publication n’est possible à l’aide de ce nœud.

Suppression

Aucune suppression n’est possible à l’aide de ce nœud.

Mise à jour

Aucune mise à jour n’est possible à l’aide de ce nœud. Les comptes peuvent être mis à jour ou désactivés avec l’API Account Management.

Arêtes

Nom de l’arêteDescription

/events

Évènements de cette personne. Par défaut, les évènements refusés par la personne ou laissés sans réponse sont exclus.

/feed

Fil des publications (y compris les mises à jour de statut) et liens publiés par cette personne.

/conversations

Messages Workplace d’une personne ou d’une page de bot. Nécessite l’autorisation Lire tous les messages

/managers

Responsable(s) d’une personne.

/reports

Subordonné(s) d’une personne.

/picture

Images de profil du membre.

/groups

Groupes auxquels appartient un membre.

Exemples

Récupérer les informations concernant le membre d’une communauté


Obtenir le nom et l’adresse e-mail d’un membre

GET /{member_id}?fields=email,name HTTP/1.1
Host: graph.facebook.com


Obtenir l’ID d’un membre à partir de son adresse e-mail

GET /{email_address} HTTP/1.1
Host: graph.facebook.com


Obtenir les évènements d’un membre

GET graph.facebook.com
      /{member-id}/events

Récupérer les informations concernant les responsables et les subordonnés d’un utilisateur


Obtenir la liste des subordonnés d’un membre

GET /{member_id}/reports HTTP/1.1
Host: graph.facebook.com


Obtenir la liste des responsables d’un membre

GET /{member_id}/managers HTTP/1.1
Host: graph.facebook.com

Récupérer les messages d’un membre


Obtenir les conversations d’un membre, y compris ses messages, leur expéditeur et les pièces jointes

Nécessite le token d’intégration personnalisée avec l’autorisation Lire tous les messages.

GET graph.facebook.com
      /{member-id}/conversations?fields=messages{message,attachments,from}


Obtenir les ID des fils de conversation d’un membre, par fil de discussion

Nécessite le token d’intégration personnalisée avec l’autorisation Lire tous les messages.

GET graph.facebook.com
      /{member-id}/conversations


Obtenir les messages d’un ID de fil de discussion d’un utilisateur

Nécessite le token d’intégration personnalisée avec l’autorisation Lire tous les messages.

GET graph.facebook.com
      /{thread-id}/messages?user={user-id}


Obtenir les conversations d’une page de bot, y compris les messages et les pièces jointes

GET graph.facebook.com
      /me/conversations?fields=messages{message,attachments}

L’alias /me réfère à la page du bot quand un token d’intégration personnalisée est utilisé.


Obtenir la date et l’heure auxquelles un membre a été invité et a réclamé son compte

Nécessite le token d’intégration personnalisée avec l’autorisation Gérer les comptes.

GET graph.facebook.com
      /{member-id}?fields=account_invite_time,account_claim_time

Ces champs sont présents uniquement si le membre a été invité ou a réclamé son compte.

Supprimer un message dans la messagerie d’un membre avec un token d’intégration personnalisée

Nécessite le token d’intégration personnalisée avec l’autorisation Supprimer les messages d’une discussion.

DELETE graph.facebook.com
      /{message-id}?user={user-id}

Le message disparaît uniquement de la messagerie du membre spécifié dans la requête. Les autres membres disposant du message peuvent toujours le voir. Pour supprimer définitivement le message, vous devez le supprimer pour tous les membres concernés.

Obtenir le statut sur le terrain de l’utilisateur

GET graph.facebook.com
      /{user-id}?fields=frontline
      
    {
      "frontline": {
        "is_frontline": true
      },
    "id": "100038142594104"
    }