登入開始免費試用
easyCoexistence 官方 API

透過 API 發佈 Facebook 專頁限時動態

Meta 的限時動態 API 可將相片及影片限時動態發佈至 Facebook 專頁。相片限時動態需先將 published 設為 false 上傳相片,再以其 photo_id 呼叫 POST /{page-id}/photo_stories;影片限時動態則透過 /{page-id}/video_stories 的 start、上傳及 finish 三次呼叫完成。影片限時動態最長 60 秒,相片最大 10 MB。

easyCoexistence 可讓您透過 Claude、ChatGPT 或自家程式,以 publish_facebook_post 發佈 Facebook 專頁的帖文,包括文字、連結、相片及影片。

60 seconds

Meta 在 Facebook 專頁上允許的影片限時動態最長時長。

10 MB

相片限時動態的最大檔案大小,格式可為 JPEG、BMP、PNG、GIF 或 TIFF。

9 x 16

影片限時動態的長寬比,建議 1080 x 1920 像素,最低 540 x 960 像素。

PUBLISHED, ARCHIVED

GET /{page-id}/stories 回報的狀態;已存檔的限時動態只會在專頁的限時動態存檔開啟時顯示。

相片限時動態如何發佈?

分兩步完成。先將相片上傳至 POST /{page-id}/photos,並將 published 設為 false,此呼叫會返回相片的 ID;然後以該 ID 作為 photo_id,發送 POST /{page-id}/photo_stories。Meta 會以 success 設為 true 回應,並返回 post_id,即該限時動態帖文的 ID。

Publishing a photo story
POST /{page-id}/photo_stories
{
  "photo_id": "<PHOTO_ID>"
}

200 OK
{
  "success": true,
  "post_id": "<STORY_POST_ID>"
}

影片限時動態如何發佈?

分三步完成,與 Reel 的流程相同。以 upload_phase 設為 start 呼叫 POST /{page-id}/video_stories,會返回 video_id 及位於 rupload.facebook.com 的 upload_url。影片須上傳至該網址,可以檔案位元組加上 offset 及 file_size 標頭傳送,若為託管檔案則使用 file_url 標頭。之後以 video_id 及 upload_phase 設為 finish 再次呼叫 POST /{page-id}/video_stories,即可發佈,並返回 post_id。

1StartPOST /{page-id}/video_stories, upload_phase start
2UploadThe bytes or a file_url, sent to the upload_url
3StatusGET /{video-id}?fields=status
4Finishupload_phase finish with video_id: returns post_id

限時動態可以使用哪些媒體?

Meta 的限時動態指南分別列出相片及影片的規格。相片須為 .jpeg、.bmp、.png、.gif 或 .tiff 檔案,大小最高 10 MB,其中 PNG 最好維持在 1 MB 以下。影片沿用 Reels 規格,但時長上限較短:

  • 檔案:建議使用 .mp4,長寬比為 9 x 16。
  • 解像度:建議 1080 x 1920 像素,最低 540 x 960 像素。
  • 幀率:固定為每秒 24 至 60 幀,並採用逐行掃描。
  • 時長:影片限時動態最長 60 秒。
  • 編解碼器:H.264 或 H.265,亦支援 VP9 及 AV1;音訊採用 AAC Low Complexity,48 kHz、立體聲、128 kbps 或以上。

哪些媒體不能用於限時動態?

已在先前發佈的帖文中使用過的相片或影片。Meta 的規則是,為限時動態上傳的媒體不得曾用於其他帖文。託管影片也必須可以存取,因為若網站的 robots.txt 封鎖了 facebookexternalhit/1.1 用戶代理,Meta 會拒絕該檔案;來自 Meta 自家 CDN 的檔案(例如 fbcdn 網址)同樣不能使用。

如何列出專頁的限時動態?

GET /{page-id}/stories 會為每個限時動態返回一個物件,列表可按狀態篩選,或以 since 及 until 按日期篩選。每個物件包括:

  • post_id:限時動態帖文的 ID。
  • status:PUBLISHED 或 ARCHIVED;已存檔的限時動態需要專頁的限時動態存檔已開啟。
  • creation_time:限時動態發佈時的 UNIX 時間戳。
  • media_type 及 media_id:相片或影片,以及該媒體的 ID。
  • url:限時動態的 Facebook 網址,位於 facebook.com/stories/ 之下。

需要哪些權限?

須由能在專頁上執行 CREATE_CONTENT 任務的人士取得專頁存取權杖,透過 Facebook Login 或 Facebook Login for Business 取得,並授予 pages_manage_posts、pages_read_engagement 及 pages_show_list。以業務系統用戶身分發出的要求,還需要 business_management。這三項權限與發佈至專頁動態消息所需的權限相同。

限時動態何時發佈?

在 photo_stories 呼叫,或 video_stories 的 finish 呼叫發出時即會發佈。Meta 的限時動態 API 不設發佈時間參數:photo_stories 接受 photo_id,而 finish 呼叫則接受 video_id、upload_phase 及可選的 is_ai_generated 旗標。若要定時發佈,須由您自行的排程工具在該時刻發出呼叫。

如何透過 easyCoexistence 發佈限時動態?

目前還不能。publish_facebook_post 用於發佈帖文,而非限時動態,而 easyCoexistence 沒有 photo_stories 或 video_stories 的工具;專頁存取權杖不會提供,因此您也無法透過自己的程式碼在其連接上執行這些呼叫。請在 Facebook 或 Meta Business Suite 發佈限時動態。

常見錯誤

  • 重用早前帖文中的相片。限時動態的媒體不能來自已發佈的帖文,因此請將 published 設為 false 重新上傳。
  • 把 90 秒的 Reel 改為限時動態。Reels 最長可達 90 秒,但影片限時動態的上限為 60 秒。
  • 預期列表會顯示已存檔的限時動態。只有在專頁的限時動態存檔開啟時,已存檔的限時動態才會出現在 GET /{page-id}/stories 中。
  • 把影片發送至 graph.facebook.com。上傳應送至 rupload.facebook.com 的 upload_url;start、finish 及狀態呼叫則仍留在 graph.facebook.com。
使用 EasyCoexistence 完成這項設定

它沒有限時動態 API 的工具,因此限時動態須在 Facebook 或 Meta Business Suite 發佈。每個連接每月 US$ 9 至 US$ 0.75,連接越多越便宜,並提供首 3 天免費試用。

常見問題

Reel 可以分享為 Facebook 專頁限時動態嗎?

可以,前提是長度為 60 秒或以下:Meta 的規格指出,以限時動態形式發佈到專頁的 Reel 不能超過該長度。

影片限時動態可以標示為 AI 製作嗎?

可以。在 video_stories 的 finish 呼叫中將 is_ai_generated 設為 true;預設為 false。

如果限時動態的影片上傳中斷,該怎麼辦?

將 offset 設為 0 重新上傳以重新開始,或將 offset 設為狀態檢查回傳的 bytes_transfered 值以續傳。

easyCoexistence 為 Facebook 專頁收費多少?

每個連接每月 US$ 9 至 US$ 0.75,並提供首 3 天免費試用。每個專頁為一個連接,增加連接數量時,每個連接的價格會下降。

繼續閱讀

兩分鐘內連接您的第一個頻道。

無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。

  • 免費試用 3 天
  • 隨時取消
  • 只用官方 API
  • 24/7 監察

驗證日期