Workplace

Publication

Chemin /{POST-id}

Représente une publication Workplace. Le nœud /{post-id} renvoie une publication unique.

Lecture

Renvoie un objet Post unique représentant une publication dans un groupe, un évènement ou sur le profil d’un utilisateur.

Autorisations

La lecture d’un nœud de publication nécessite l’autorisation Lire le contenu du groupe. La lecture d’une publication sur le profil d’un utilisateur nécessite l’autorisation Lire le journal des utilisateurs.

Champs

Nom du champDescriptionType

id

ID de publication au format {group-id}_{id}.

string

created_time

Heure de mise en ligne initiale de la publication.

datetime

formatting

Indication précisant si la publication a été créée à l’aide d’un langage de marquage de formatage. La valeur renvoyée indique le langage de marquage utilisé. Workplace prend en charge Markdown et le texte brut.

enum {MARKDOWN|PLAINTEXT}

from

Informations concernant la personne ou le profil qui a publié le message.

Profile

icon

Lien vers une icône correspondant au type de cette publication.

url

link

Lien associé à cette publication.

url

message

Message d’état dans la publication.

string

name

Nom du link, s’il est associé à la publication.

string

object_id

ID d’une photo importée ou d’une vidéo jointe à la publication.

string

permalink_url

URL de la page de lien permanent de la publication.

url

picture

Image récupérée à partir d’un link inclus dans la publication.

url

place

Toute information de lieu associée à la publication.

Place

poll

Si la publication est un sondage, ce champ renvoie l’objet Question associé, ce qui vous permet de voir les options et les votes aux options exprimés par les utilisateurs.

Question

properties

Liste de propriétés d’une vidéo jointe, par exemple, la durée de la vidéo.

object[]

status_type

Description du type d’une mise à jour d’état.

enum {mobile_status_update, created_note, added_photos, added_video, shared_story, created_group, created_event, wall_post, app_created_story, published_story, tagged_in_photo}

story

Texte des stories non générées intentionnellement par les utilisateurs.

string

to

Profils mentionnés ou ciblés dans cette publication.

Profile[]

type

Chaîne indiquant le type d’objet de cette publication.

enum{link, status, photo, video}

updated_time

Heure de création ou de dernière modification de la publication, ou heure du dernier commentaire laissé pour cette publication.

datetime

Publication

Vous ne pouvez pas effectuer de publication à l’aide de cette arête. Pour effectuer une nouvelle publication dans un groupe, utilisez l’arête /group/feed.

Suppression

Il est possible de supprimer une publication via l’API Graph en effectuant une requête DELETE sur le chemin /{post_id}.

Autorisations

La suppression d’un nœud de publication requiert à la fois l’autorisation Publier dans les groupes et l’autorisation Lire tout le contenu ou Lire uniquement le contenu ouvert, selon le groupe dans lequel la publication a été effectuée.

La suppression d’une publication du journal d’un utilisateur nécessite l’autorisation Gérer le journal des utilisateurs.

Mise à jour

Seules les publications créées par un bot peuvent être mises à jour ; les publications effectuées pour le compte d’un utilisateur avec un impersonate_token ne peuvent pas l’être. Il est possible de modifier une publication en effectuant une requête POST sur l’arête /{post-id} avec un message mis à jour dans le corps.

Arêtes

Nom de l’arêteDescription

/attachments

Ensemble des pièces jointes de contenu multimédia associées à cette publication.

/comments

Commentaires sur cette publication. Ce champ prend en charge un champ summary pour permettre d’obtenir un nombre total.

/reactions

Personnes ayant réagi à cette publication. Ce champ prend en charge un champ summary pour permettre d’obtenir un nombre total. Il prend également en charge les champs since=unix_timstamp et until=unix_timestamp pour indiquer le nombre de réactions sur une période donnée.

/seen

Personnes ayant vu cette publication. Ce champ prend en charge un champ summary pour permettre d’obtenir un nombre total. Il prend également en charge les champs since=unix_timstamp et until=unix_timestamp pour indiquer le nombre de personnes ayant vu la publication sur une période donnée.


Notez que ce champ est soumis aux mêmes limitations que celles décrites sur cette page.

Syntaxe Markdown prise en charge

La syntaxe Markdown prise en charge lors de la mise en ligne d’une publication sur Workplace est la suivante :

FormatageSyntaxe

Gras

**Bold**

Accentuation

*Emphasize*

Lien

[Link](https://workplace.fb.com)

Inline code

`Inline code`
code block
``` code block ```
  • Liste
* List
  1. Liste numérotée
1. Numbered list

Citation

> Quote

Titre 1

# Heading 1

Titre 2

## Heading 2

Exemples

Obtenir les éléments ID, source et story d’une publication

GET graph.facebook.com
  /{post-id}?fields=id,source,story

Obtenir les commentaires d’une publication

GET graph.facebook.com
  /{post-id}/comments

Obtenir l’état de consultation d’une publication, y compris un nombre récapitulatif total

GET graph.facebook.com
  /{group-id}_{post-id}/seen?
  summary=true

Publier dans un groupe

POST graph.facebook.com
  /{group-id}/feed?
  message=Hello+World&
  link=https://developers.facebook.com/docs/workplace/custom-integrations/apps

Identifier un utilisateur dans une publication de groupe

POST graph.facebook.com
  /{group-id}/feed?
  message=Hi+@[100013325822531]

Publier dans un groupe avec un formatage Markdown

POST graph.facebook.com
  /{group-id}/feed?
  message=This+is+a+**formatted**+*post*&
  formatting=MARKDOWN

Lire les options des questions d’un sondage et les votes sur une publication de sondage à l’aide de l’élargissement de champ

GET graph.facebook.com
  /{post-id}?
  fields=message,poll{options{name,vote_count,votes}}

Supprimer une publication

DELETE graph.facebook.com
  /{post-id}

Voir les personnes ayant réagi à une publication ou ayant consulté une publication sur une période donnée

GET graph.facebook.com
  /{post-id}/seen?
        since=1577836800&
        until=1593561600