Workplace from Meta 即将停用。您可以继续使用 Workplace，直到 2025 年 8 月 31 日为止。详情请访问我们的帮助中心。

帖子

路径 `/{POST-id}`

表示一篇 Workplace 帖子。/{post-id} 节点会返回一篇帖子。

读取

返回一个帖子对象，此对象代表某个小组、事件或用户个人主页中的一篇帖子。

权限

读取帖子节点需要拥有读取小组内容的权限。读取用户个人主页中的帖子需要拥有读取用户时间线的权限。

字段

字段名称	描述	类型
`id`	帖子编号，使用的格式为 `{group-id}_{id}`。	`string`
`created_time`	帖子的最初发布时间。	`datetime`
`formatting`	表示帖子是否使用格式标记语言创建。返回值表示使用的是哪一种标记语言。Workplace 支持 Markdown 和纯文本。	`enum {MARKDOWN\|PLAINTEXT}`
`from`	发布消息的用户或个人主页的相关信息。	`Profile`
`icon`	表示此帖子类型的图标链接。	`url`
`link`	附加至此帖子的链接。	`url`
`message`	此帖子中的状态消息。	`string`
`name`	附加至此帖子的 `link` 的名称。	`string`
`object_id`	附加至此帖子的任何已上传照片或视频的编号。	`string`
`permalink_url`	指向帖子固定链接页面的网址。	`url`
`picture`	从帖子包含的任何 `link` 中抓取的图片。	`url`
`place`	附加至此帖子的位置信息。	`Place`
`poll`	对于投票帖，此字段将返回所附加的问题对象，供您查看 `options` 和用户做出的 `votes`。	`Question`
`properties`	任何附加视频的属性列表，例如视频时长。	`object[]`
`status_type`	动态更新类型的描述。	`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`	用户无意生成的动态中的文本。	`string`
`to`	帖子中提及或定位的个人主页。	`Profile[]`
`type`	表示此帖子对象类型的字符串。	`enum{link, status, photo, video}`
`updated_time`	帖子创建的时间、最后编辑的时间或帖子中最新评论发表的时间。	`datetime`

发布

您无法使用此连线发布对话。如要在小组中发布新帖子，请使用 /group/feed 连线。

删除

如要删除某个帖子，可以通过图谱 API 向路径 /{post_id} 发送 DELETE 请求。

权限

如要删除帖子节点，需要同时获得向小组发布内容的权限以及读取所有内容或仅读取公开内容的权限，具体取决于发布帖子的小组。

如要删除用户时间线中的帖子，需要获得管理用户时间线的权限。

更新

只能更新由机器人创建的帖子，不能更新使用 impersonate_token 代表用户发布的帖子。如要更新帖子，可以向 /{post-id} 连线发送 POST 请求，并在正文中加入更新后的 message。

连线

连线名称	描述
`/attachments`	与此帖子关联的所有媒体附件。
`/comments`	对此帖子的评论。支持使用 `summary` 字段获取总数。
`/reactions`	给此帖子留下心情的用户。支持使用 `summary` 字段获取总数。支持使用 `since=unix_timstamp` 和 `until=unix_timestamp` 字段获取某个时间范围内获得的心情总数。
`/seen`	已读过此帖子的用户。支持使用 `summary` 字段获取总数。支持使用 `since=unix_timstamp` 和 `until=unix_timestamp` 字段获取某个时间范围内已读过此帖子的用户总数。注意，此连线受此处所述的相同限制的约束

支持的 Markdown 语法

在 Workplace 中发布帖子时，支持以下 Markdown 语法：

设置格式	语法
粗体	`Bold`
斜体	`Emphasize`
链接	`[Link](https://workplace.fb.com)`
`Inline code`	`Inline code`
`code block`	``` code block ```
清单	`* List`
编号清单	`1. Numbered list`
引述	`> Quote`
标题 1	`# Heading 1`
标题 2	`## Heading 2`

示例

获取帖子的 `ID`、`source` 和 `story`

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

获取帖子中的评论

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

获取帖子的已读状态，包括已读总数摘要

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

在小组中发布帖子

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

在小组帖子中提及用户

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

使用 Markdown 格式在小组中发布帖子

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

使用字段扩展读取投票帖子中的投票问题选项和相应票数

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

删除帖子

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

获取某个时间范围内的心情/已读总数

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

帖子

路径 /{POST-id}

读取

权限

字段

发布

删除

权限

更新

连线