貼文

路徑 /{POST-id}

代表 Workplace 貼文。/{post-id} 節點傳回單一貼文。

讀取

傳回單一貼文物件,代表社團、活動或用戶個人檔案上的貼文。

權限

若要讀取貼文節點,您需要讀取社團內容權限。

欄位

欄位名稱說明Type

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

如果貼文是票選活動 ,此欄位將會傳回附加的「問題」物件,讓您能看到用戶設定的 optionsvotes 選項。

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

with_tags

標註和貼文發佈者「在一起」的個人檔案。

具有包含 Profile 物件清單之 data 欄位的 JSON 物件。

發佈

您無法使用這個關係連線發佈內容。若要在社團中發佈新貼文,請使用 /group/feed 關係連線。

刪除

您可透過圖形 API,在 /{post_id} 路徑上提出 DELETE 要求來刪除貼文。

權限

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

更新

只能更新 Bot(機器人程式)建立的貼文,使用 impersonate_token 代表用戶建立的貼文則無法更新。您可透過在 /{post-id} 關係連線上提出 POST 要求,並在內文中使用更新的 message 來編輯貼文。

關係連線

關係連線名稱說明

/attachments

與此貼文關聯的所有媒體附件。

/comments

此貼文的留言。支援 summary 欄位以取得總計。

/likes

對此貼文按讚的用戶。支援 summary 欄位以取得總計。

/reactions

對此貼文傳達心情的用戶。支援 summary 欄位以取得總計。

/seen

看過此貼文的用戶。支援 summary 欄位以取得總計。

支援的 Markdown 語法

當在 Workplace 發佈貼文時,支援下列 Markdown 語法:

格式語法

粗體

**Bold**

強調

*Emphasize*

連結

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

Inline code

`Inline code`
code block
``` code block ```
  • 清單
* List
  1. 編號清單
1. Numbered list

引號

> Quote

標題 1

# Heading 1

標題 2

## Heading 2

範例

取得貼文的 IDsourcestory

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

取得貼文的留言

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

取得貼文的讀取統計資料,包括總計摘要

GET graph.facebook.com
  /{post-id}/comments?
  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}}