發布相片至 Facebook 粉絲專頁:單張及多張相片貼文
相片可透過 POST /{page-id}/photos 發布至 Facebook 粉絲專頁。url 設為已在網上的圖片,或以 multipart/form-data 附上檔案,caption 即相片文字。若要以一則貼文發布多張相片,請將每張相片以 published 設為 false 上載,並以 media_fbid 項目將其 ID 放入 attached_media,發送至 POST /{page-id}/feed。
easyCoexistence 可讓 Claude、ChatGPT 或您自己的程式碼透過 publish_facebook_post 發布相片至 Facebook 粉絲專頁,可即時發布,或定時發布至 90 天後,每則貼文一張相片;多張相片的貼文則須在 Facebook 或 Meta Business Suite 建立。
photos 端點接受的最大相片檔案大小;Meta 建議 PNG 檔案保持在 1 MB 以下,以免出現像素化。
未發布相片可在 Meta 伺服器上保留的時間;該時間內未發布的相片會被刪除。
photos 端點在相片檔案遺失或無效時返回的錯誤代碼。
定時貼文中相片的參數:published 必須為 false,且相片本身不接受 scheduled_publish_time。
發布相片時,與相片 id 一同返回的值:載有該相片的專頁貼文 ID。
如何向專頁發布單張相片?
發送 POST /{page-id}/photos,並將 url 設為已在網上的相片,或以 multipart/form-data 附上檔案,該欄位以往稱為 source。caption 即相片的文字,支援 emoji。Meta 會返回兩個 ID:id 為相片,post_id 為載有該相片的專頁貼文。
POST /{page-id}/photos
{
"url": "https://example.com/flyer.jpg",
"caption": "Doors open at 9 on Saturday."
}
200 OK
{
"id": "<PHOTO_ID>",
"post_id": "<PAGE_POST_ID>"
}Meta 記錄了哪些相片參數?
除了 url 與 caption 外,相片的參考資料中還列出了一些可影響相片發布方式的選項:
- published:預設為 true;設為 false 時會上載相片但不發布。
no_story:設為 true 時,會隱藏應用程式上載相片時 Meta 自動生成的動態消息。alt_text_custom:相片的無障礙替代文字說明。scheduled_publish_time:未發布相片貼文應定時發布的時間,僅適用於專頁。- place:代表位置的專頁 ID;
backdated_time設定較早的建立時間。 - message:已標示為棄用,改以 caption 取代。
Meta 接受哪些圖像檔案?
JPEG、BMP、PNG、GIF 及 TIFF,每個檔案最多 10 MB。Meta 建議 PNG 檔案保持在 1 MB 以下,因為較大的檔案可能出現像素化。發布前,Facebook 會移除圖像中的位置資訊,並縮放成多種尺寸以供呈現;若檔案遺失或無法讀取,會返回錯誤 324。
如何在一則貼文中發布多張相片?
分兩個步驟。將每張相片以 published 設為 false 上載至 POST /{page-id}/photos,此步驟會返回其 ID,但不會發布任何內容。然後發送 POST /{page-id}/feed,附上 message 及 attached_media,每張相片一個 media_fbid,Meta 會返回單一貼文的 ID,該貼文會一同顯示所有相片。未發布的相片會在 Meta 伺服器保留約 24 小時,因此請在該時限內發送 feed 請求。
多張相片貼文如何定時發布?
使用 Meta 本身的定時功能。將相片以 published 設為 false、temporary 設為 true 上載,然後發送 feed 請求,設定 published 為 false、scheduled_publish_time,並將 unpublished_content_type 設為 SCHEDULED。Meta 的專頁指南要求發布時間設於請求後 10 分鐘至 30 天之間,Meta 會將貼文保留至該時間。
publish_facebook_post 如何處理相片?
需要 account_id、image_url(一個公開的 HTTPS 圖片連結),以及 message,即貼文的文字。一則貼文只能載有一張圖片,附帶的連結會被拒絕,因此網址應放入 message。若沒有 scheduled_at,相片會即時發布;若設定 scheduled_at,可提前 1 分鐘至 90 天,格式為附有時區的 ISO 8601,easyCoexistence 會在定時發布時複製圖片並發布。Facebook 對相片的 10 MB 限制仍然適用,不過複製步驟可接受最大 30 MB 的圖片。
如何透過 easyCoexistence 發布多張相片?
目前還不能。publish_facebook_post 只接受一個 image_url,而 easyCoexistence 沒有可進行 Meta 所記載之兩步驟呼叫的工具:對每張圖片各發送一次 POST 至 <PAGE_ID>/photos,附上 url 並將 published 設為 false,再將返回的 ID 一併發送至 <PAGE_ID>/feed。請在 Facebook 或 Meta Business Suite 發布相簿,或將相片分開以個別貼文發布。
常見錯誤
- 一次請求發布一張相片。若 published 保持為 true,每次對 /photos 的請求都會建立獨立貼文;應將其以未發布狀態上載,再附加至同一則動態消息貼文。
- 等待超過一天才附加未發布的相片。Meta 只會保留約 24 小時,之後便會刪除。
- 定時貼文的相片未設定 temporary。Meta 要求附加於定時貼文的相片須將 temporary 設為 true,並將 published 設為 false。
- 編輯相片的 id,而非貼文。photos 端點會返回相片的 id 及貼文的 post_id;文字修改須針對 post_id。
每個連接每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,首 3 天免費。
常見問題
Facebook 相片貼文可以有替代文字嗎?
可以。/{page-id}/photos 上的 alt_text_custom 可設定相片的無障礙替代文字說明。publish_facebook_post 不接受此參數,因此請在相片發布後於 Facebook 上加入該說明。
Facebook 會保留相片的位置資料嗎?
不會。Meta 會在發布前移除位置資料;如要顯示地點,請將 place 設為該地點的專頁 ID。
單張相片貼文可以定時發布嗎?
可以。publish_facebook_post 加上 scheduled_at,會將其保存於 easyCoexistence 的佇列中,可提前 1 分鐘至 90 天。在 Meta 一方,將 published 設為 false 並加上 scheduled_publish_time,同樣可以定時發布。
easyCoexistence 為 Facebook 專頁收費多少?
您每連接一個專頁即計為一個連接,每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,首 3 天免費。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期