這份文件已更新。
中文(香港) 的翻譯尚未完成。

英文更新時間：9月11日
中文(香港) 更新時間：2023年4月19日

我們即將停用 Workplace from Meta。在 2025 年 8 月 31 日之前，您將可繼續使用 Workplace。請參閱我們的使用說明以瞭解詳情。

貼文

路徑 `/{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。	`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 要求來刪除貼文。

權限

若要刪除貼文節點，您需要發佈到社團權限，以及讀取所有內容或僅讀取公開內容這兩個權限的任一個（根據發佈貼文的社團而定）。

若要從用戶的動態時報刪除貼文，您需要管理用戶動態時報權限。

更新

只能更新 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}

讀取

權限

欄位

發佈

刪除

權限

更新