Communauté

Chemin /community

Autre chemin /company

Représente votre communauté Workplace. Le nœud /community (ou /company, qui peut être utilisé de manière interchangeable) renvoie un seul objet « community » de type groupe. Si cela est plus pratique pour l’API, vous pouvez considérer l’objet racine « community » comme un groupe racine pour les autres groupes ou communautés.

Pour obtenir l’ID de votre communauté, envoyez à l’API Graph un appel GET pour graph.facebook.com/community avec un token d’accès d’intégration personnalisé.

Dans certains cas, une communauté racine peut également contenir d’autres communautés. Celles-ci sont alors affichées dans l’arête /groups de la communauté racine. Le champ is_community permet de distinguer les communautés enfants et les groupes enfants d’une communauté racine.

L’existence d’une ou de plusieurs communautés dans une communauté racine indique que « community » est activé pour cette instance Workplace.

Vous pouvez ensuite appeler l’arête /groups de ces communautés enfants pour obtenir les groupes de cette communauté. Dans tous les cas, l’arête /groups montrera uniquement les descendants directs de cette communauté, sans récursion.

L’API ne permet pas de créer de communauté, mais il est possible de gérer les membres de la même manière que les membres de groupes.

Lecture

GET graph.facebook.com
  /community

Autorisations

Le nœud « community » nécessite l’autorisation Lire le contenu du groupe ou Gérer les groupes.

Publication

Vous ne pouvez pas publier de communauté Workplace avec ce nœud.

Suppression

Vous ne pouvez pas supprimer une communauté Workplace avec ce nœud.

Mise à jour

Vous ne pouvez pas mettre à jour une communauté Workplace avec ce nœud.

Arêtes

Exemples

Créer un groupe

Vous pouvez créer un groupe pour une communauté Workplace en envoyant une requête POST à l’arête /community/groups. La réponse contiendra l’ID du nouveau groupe ainsi créé. Notez que le groupe n’affiche pas de membre tant que vous n’avez pas ajouté au moins un membre, et désigné celui-ci comme admin.

POST graph.facebook.com
  /community/groups?
    name={...}&
    description={...}&
    privacy=OPEN

Obtenir une liste de tous les groupes et communautés d’une communauté racine :

GET graph.facebook.com
  /community/groups?fields=is_community

Obtenir une liste de l’ensemble des membres d’une communauté racine :

GET graph.facebook.com
  /community/members

Obtenir une liste de l’ensemble des membres d’une communauté racine, filtrée par external_id :

GET /community/members?
  external_ids=12356,abc123

Signaler un élément d’un contenu (notez que cette arête est désactivée depuis le 30 avril 2019) :

POST graph.facebook.com
  /community/reported_content?
    content_id={...}

Ajouter un groupe à une communauté racine :

POST graph.facebook.com
  /community/groups?
    name={...}&
    description={...}&
    privacy=OPEN

Ajouter un groupe à une communauté non racine :

POST graph.facebook.com
  /{community-id}/groups?
    name={...}&
    description={...}&
    privacy=OPEN

Provisionner un compte :

POST graph.facebook.com
  /community/accounts?
    name={...}&
    email={...}&
    department={...}&
    division={...}&
    organization={...}&
    title={...}&
    manager={...}&
    hire_date={...}&
    invite={...}&
    active={...}

Obtenir une liste de tous les badges :

GET graph.facebook.com
  /community/badges?fields=id,name,description,icon,category

Obtenir une liste des catégories au niveau racine :

GET graph.facebook.com
  /community/knowledge_library_categories

Publier une nouvelle catégorie au niveau racine :

POST graph.facebook.com
  /community/knowledge_library_categories?
  title={...}&
  icon={...}&
  color={...}&
  json_content={...}

Obtenir une liste des liens des outils les plus utilisés et d’autres ressources de la bibliothèque de connaissances :

GET graph.facebook.com
        /community/knowledge_quick_links?fields=title,link

Lire un lien rapide précis dans la bibliothèque de connaissances

GET graph.facebook.com
        /{quick_link_id}?fields=title,link

Ajouter un lien rapide dans la bibliothèque de connaissances

POST graph.facebook.com
        /community/knowledge_quick_links?
        title={...}&
        link={...}

Modifier un lien rapide précis dans la bibliothèque de connaissances

POST graph.facebook.com
        /{quick_link_id}?
        title={...}&
        link={...}

Supprimer un lien rapide précis dans la bibliothèque de connaissances

DELETE graph.facebook.com
        /{quick_link_id}