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

透過 API 發布影片到 Facebook 專頁

影片經由 POST /{page-id}/videos 發布到 Facebook 專頁,可使用 file_url(由 Meta 自行下載的網址),或由應用程式先把檔案上傳至 Meta。title 為影片命名,description 則是 Meta 發布貼文時可能顯示的文字。之後 Meta 會處理檔案,GET /{video-id}?fields=status 會將 video_status 顯示為 processing,直至變為 ready。

easyCoexistence 可透過 publish_facebook_post 從 Claude、ChatGPT 或您自己的程式發布影片到 Facebook 專頁,可即時發布,亦可排程至 90 日後。

389

Meta 無法從 file_url 指定的網址取得影片檔案時的錯誤代碼。

382

影片檔案過小無法上傳時的錯誤代碼;Meta 會要求較大的檔案。

10 min to 6 months

videos 端點上 scheduled_publish_time 的時間範圍,由影片發布時開始計算。

0 to 100

processing_progress 的範圍,即影片處理完成的百分比,與 video_status 並列回傳。

graph.facebook.com

影片上傳的主機,依據 Meta 的 Video API 概覽,該概覽將 graph-video.facebook.com 標示為已棄用。

h

上傳時回傳的檔案控制代碼,以 fbuploader_video_file_chunk 傳給 /{page-id}/videos 以發布影片。

影片如何發布到專頁?

使用 POST /{page-id}/videos 並搭配專頁存取權杖。檔案有兩種方式送達 Meta:file_url,即 Meta 自行抓取的影片公開網址;或上傳,由應用程式先傳送位元組。file_url 不能與 upload_phase 併用,upload_phase 是分段上傳的參數,因此每個請求只能採用其中一種方式。

file_urlUploaded file
Where the video isAt a URL Meta can reachOn your own system
On /{page-id}/videosfile_urlfbuploader_video_file_chunk with the upload's handle
Before publishingNothing: Meta fetches the fileAn upload session, then the bytes
If it failsError 389 when Meta cannot fetch itResume from the offset Meta reports

檔案不在線上時,上傳如何運作?

Meta 的影片發布指南採用 Resumable Upload API。以 file_name、file_length 和 file_type 呼叫 POST /{app-id}/uploads 可開啟一個會話;再以 file_offset 標頭及位元組呼叫 POST /upload:{session-id},即會回傳控制代碼 h。之後以 POST /{page-id}/videos 並將 fbuploader_video_file_chunk 設為該控制代碼,連同 title 和 description 發布影片。這些上傳呼叫須使用用戶存取權杖。

  • 中斷的上傳可從 GET /upload:{session-id} 回傳的 file_offset 續傳。
  • 影片參考文件亦記錄同一端點上的分段上傳:upload_phase 的 start、transfer 和 finish,並搭配 start_offset、file_size 與 video_file_chunk。

title 和 description 有何作用?

title 是影片的標題。description 按 Meta 的說法,是可能會在相關動態中顯示的貼文描述文字,因此貼文的內容文字會放在這裡。兩者在 videos 端點上皆為選填,而 publish_facebook_post 會把其 message 作為 description 傳送,並不設定 title。

怎樣知道影片已就緒?

Meta 在影片送達後會進行處理。GET /{video-id}?fields=status 會回傳 video_status:Meta 處理期間顯示 processing;影片完成上傳、編碼並產生縮圖後顯示 ready;若處理失敗則顯示 error。processing_progress 則以 0 至 100 表示已完成的百分比。Meta 也可透過 videos 欄位的專頁 Webhook 回報發布狀態,但 easyCoexistence 並未訂閱此欄位。

影片可以多大、多長?

專頁影片參考文件與 Meta 的影片發布指南均未列出最大檔案大小或長度;兩者列出的大小規則是錯誤 382,即檔案過小無法上傳。Meta 的 Reels 與影片限時動態指南另有各自的時長規定:Reel 為 3 至 90 秒,影片限時動態最長 60 秒。easyCoexistence 排程影片時,會在排程當下複製檔案,並拒絕超過 1 GB 的檔案。

需要哪些權限及專頁任務?

根據影片參考文件與發布指南,需要 pages_manage_posts、pages_read_engagement 及 pages_show_list,並使用由可執行 CREATE_CONTENT 任務者取得的專頁權杖。Meta 的 Video API 概覽措辭較為嚴格:該人士應能執行與管理員同等的專頁任務,或持有透過 Business Manager 授予的管理員角色。

影片貼文可能回傳哪些錯誤?

Meta 的影片參考文件列出 POST /{page-id}/videos 的以下錯誤:

  • 389:無法從網址取得影片檔案。
  • 382:影片檔案過小;請改用較大的檔案再試。
  • 6000:上傳影片檔案時出現問題;請改用其他檔案再試。
  • 6001:上傳影片時出現問題;請再試。
  • 368:該操作被視為濫用,或屬不被允許的操作。
  • 100:參數無效;200:權限錯誤;190:OAuth 2.0 存取權杖無效。

publish_facebook_post 如何發布影片?

它接受 video_url(即檔案的公開 HTTPS 連結)及 message,並將兩者以 file_url 和 description 的形式傳送到 /{page-id}/videos,因此由 Meta 自行抓取影片。每則貼文只能包含一段影片,與影片一併附上的連結會被拒絕,因此請把網址放在 message 中。結果中的 post_id 為 Meta 回傳的 ID,對影片而言即影片本身的 ID。

影片貼文如何排程?

為 publish_facebook_post 提供 ISO 8601 格式並附時區的 scheduled_at,時間範圍為由現在起 1 分鐘至 90 日後。easyCoexistence 會在排程時複製影片,並於指定時間發布到專頁;list_scheduled_posts 會列出該貼文,update_scheduled_post 可更改時間或內容,cancel_scheduled_post 則可取消。Meta 自身 videos 端點上的 scheduled_publish_time 則允許 10 分鐘至 6 個月。

常見錯誤

  • file_url 指向的是播放影片的網頁,而非影片檔案本身。Meta 會自行抓取該網址,若無法取得便會失敗並回傳錯誤 389。
  • 上傳至 graph-video.facebook.com。Meta 的 Video API 概覽已將此主機標示為影片上傳的棄用主機,並要求改用 graph.facebook.com。
  • 影片未就緒便宣布發布。請檢查狀態,直至 video_status 顯示 ready,因為發布呼叫返回後處理仍會繼續。
  • 與影片一併傳送連結。publish_facebook_post 會拒絕與檔案並存的連結;請改將網址寫入 message。
使用 EasyCoexistence 完成這項設定

您的平台也可在 Partner API 上使用 POST /channels/:id/posts 完成相同操作。每個連接每月 US$ 9 至 US$ 0.75,連接數目越多,每個連接的費用越低,前 3 日免費試用。

常見問題

可以透過 API 從電腦上傳影片到 Facebook 專頁嗎?

可以,透過 Meta 的 Resumable Upload API,它會回傳供 /{page-id}/videos 使用的控制代碼;亦可使用該端點上的分段上傳。publish_facebook_post 則接受公開的 HTTPS 網址,因此需先將檔案託管於網上。

影片可否上傳而不出現在專頁的動態消息中?

可以。published 設為 false 會暫緩貼文,no_story 會隱藏動態消息及時間線上的相關動態,secret 則令影片不會出現在 Facebook 上,亦不會被搜尋到。

同一段影片可否發布到多個專頁?

可以,透過交叉發布:已發布的影片可在該人士管理的其他專頁上發布,而無需重新上傳;每個專頁上會各自獲得一個影片 ID。

easyCoexistence 用於 Facebook 專頁的收費是多少?

每個連接每月 US$ 9 至 US$ 0.75,按您的連接總數計算,連接總數越多,單價越低,前 3 日免費試用。每個專頁即為一個連接。

繼續閱讀

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

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

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

驗證日期