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

發布相片至 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 建立。

10 MB

photos 端點接受的最大相片檔案大小;Meta 建議 PNG 檔案保持在 1 MB 以下,以免出現像素化。

About 24 hours

未發布相片可在 Meta 伺服器上保留的時間;該時間內未發布的相片會被刪除。

324

photos 端點在相片檔案遺失或無效時返回的錯誤代碼。

temporary

定時貼文中相片的參數:published 必須為 false,且相片本身不接受 scheduled_publish_time。

post_id

發布相片時,與相片 id 一同返回的值:載有該相片的專頁貼文 ID。

如何向專頁發布單張相片?

發送 POST /{page-id}/photos,並將 url 設為已在網上的相片,或以 multipart/form-data 附上檔案,該欄位以往稱為 source。caption 即相片的文字,支援 emoji。Meta 會返回兩個 ID:id 為相片,post_id 為載有該相片的專頁貼文。

Publishing a photo from a URL
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 請求。

1UploadPOST /{page-id}/photos with url and published false, once per photo
2CollectKeep the id each upload returns
3PostPOST /{page-id}/feed with message and attached_media
4ResultOne Page post ID for the photos together

多張相片貼文如何定時發布?

使用 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。
使用 EasyCoexistence 完成這項設定

每個連接每月 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 監察

驗證日期