透過 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 日後。
Meta 無法從 file_url 指定的網址取得影片檔案時的錯誤代碼。
影片檔案過小無法上傳時的錯誤代碼;Meta 會要求較大的檔案。
videos 端點上 scheduled_publish_time 的時間範圍,由影片發布時開始計算。
processing_progress 的範圍,即影片處理完成的百分比,與 video_status 並列回傳。
影片上傳的主機,依據 Meta 的 Video API 概覽,該概覽將 graph-video.facebook.com 標示為已棄用。
上傳時回傳的檔案控制代碼,以 fbuploader_video_file_chunk 傳給 /{page-id}/videos 以發布影片。
影片如何發布到專頁?
使用 POST /{page-id}/videos 並搭配專頁存取權杖。檔案有兩種方式送達 Meta:file_url,即 Meta 自行抓取的影片公開網址;或上傳,由應用程式先傳送位元組。file_url 不能與 upload_phase 併用,upload_phase 是分段上傳的參數,因此每個請求只能採用其中一種方式。
| file_url | Uploaded file | |
|---|---|---|
| Where the video is | At a URL Meta can reach | On your own system |
| On /{page-id}/videos | file_url | fbuploader_video_file_chunk with the upload's handle |
| Before publishing | Nothing: Meta fetches the file | An upload session, then the bytes |
| If it fails | Error 389 when Meta cannot fetch it | Resume 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。
您的平台也可在 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 監察
驗證日期