帖子

路徑 `/{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 關係連線。

刪除

您可透過 Graph API 在 /{post_id} 路徑上提出 DELETE 要求來刪除帖子。

權限

若要刪除帖子節點，您需要發佈到群組權限，以及讀取所有內容或僅讀取公開內容這兩個權限的其中一個（視乎您在什麼群組中發佈帖子）。

若要從用戶的生活時報刪除帖子，您需要管理用戶生活時報權限。

更新

只能更新 BOT（機械人程式）建立的帖子，無法更新使用 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}

讀取

權限

欄位

發佈

刪除

權限

更新