透過 API 發布 Instagram 輪播貼文
Instagram API 按 Meta 發布指南,把輪播發布為一則最多 20 項相片及影片的貼文,但其錯誤參考仍寫作 10。每個項目各自建立一個容器,並將 is_carousel_item 設為 true;隨後,CAROUSEL 容器以 children 參數列出這些項目,並載有說明文字。發布該容器即可一併發布所有項目,並只計為 24 小時內可透過 API 發布的 100 則貼文之一。
easyCoexistence 透過 publish_instagram_post 發布 2 至 10 項相片及影片的輪播,你可從 Claude、ChatGPT 或自己的程式使用:一次呼叫,附上項目及說明文字,即可發布貼文;如影片仍在處理中,它會自行完成。
輪播可容納的相片及影片數目,依據 Meta 發布指南及 children 參數。
錯誤代碼 100 之下的子代碼,其訊息仍寫明輪播需要 2 至 10 個項目。
輪播在 24 小時內計入 100 則 API 發布貼文上限的方式。
輪播圖片的預設裁切方式,所有圖片均跟隨第一張圖片的長寬比。
Meta 為輪播內個別相片及影片提供的 Insights 數據。
輪播如何發布?
分三個步驟進行,全部透過 POST /<IG_ID>/media 及一次發布請求完成。
- 項目:為每張相片(
image_url)或影片(media_typeVIDEO 及video_url)各建立一個容器,並將is_carousel_item設為 true,且不加說明文字。 - 輪播:建立
media_type為 CAROUSEL 的容器,將 children 設為以逗號分隔的項目容器 ID,並加入說明文字。 - 發布:呼叫 POST /<
IG_ID>/media_publish,creation_id設為輪播容器的 ID。
一個輪播最多可容納多少項目?
最多 20 項。Meta 發布指南及 POST /<IG_ID>/media 的 children 參數都將上限定為 20 項相片、影片,或兩者混合。錯誤參考仍沿用舊寫法:代碼 100、子代碼 2207028 的訊息寫明輪播至少需要 2 個、不得超過 10 個項目,因此 Meta 文件各部分都接受的數目為 2 至 10。項目可以是相片或影片,但不能是 Reels:輪播項目必定是圖片或影片容器。
輪播圖片如何裁切?
以第一張為準。輪播內每張圖片均按第一張圖片的長寬比裁切,預設為 1:1 正方形。每張圖片仍須符合一般規則:JPEG、最大 8 MB、長寬比介乎 4:5 至 1.91:1。請先放置你想要形狀的圖片,或在發布前把所有圖片統一為同一形狀。
哪些設定屬於輪播,哪些屬於各個項目?
大部分貼文層級的設定都放在輪播容器上,而非項目上。
- 說明文字:只能放在輪播容器上,項目不可加入。
- 位置:只能放在輪播容器上。
- AI 生成標籤:
is_ai_generated須放在輪播容器上,若設於項目上會返回錯誤。 - 替代文字:圖片項目支援,每項最多 1,000 個字元。
輪播如何讀取回來?
以一個 media_type 為 CAROUSEL_ALBUM 的媒體物件讀取。GET /<IG_MEDIA_ID>/children 會列出內裡的相片及影片,但部分欄位(例如 permalink)對子項無效。輪播的留言數及讚好數不包括其子項,而 Meta 只為貼文本身提供 Insights,不為個別項目提供。
輪播如何計入限制?
只計為一則貼文。一個帳戶可在滾動的 24 小時內透過 API 發布 100 則貼文,無論輪播包含多少項目,都只佔用其中一則。不過每個項目仍是一個容器,而一個帳戶可在滾動 24 小時內建立 400 個容器,因此連續發布十項輪播的情況,會在達到發布上限前先觸及容器上限。
常見錯誤
- 把說明文字加在項目上。輪播項目不支援說明文字,應在輪播容器上一次設定。
- 把 Reel 加入為項目。輪播項目只可是圖片或影片容器,Reel 不能出現在輪播內。
- 混合直向及橫向相片,卻不檢查第一張。每張圖片都會採用第一張圖片的長寬比。
- 期望每張圖片都有個別洞察數據。Meta 不為輪播內的媒體提供 Insights,只為貼文本身提供。
輪播亦可從其專屬佇列排程。每個連接每月 US$ 9 至 US$ 0.75,連接越多費用越低,首 3 天免費。
常見問題
可否透過 API 排程 Instagram 輪播?
可以,透過佇列排程,因為 Meta 會在其容器發布時發布輪播。easyCoexistence 的 publish_instagram_post 接受 scheduled_at,可提前 1 分鐘至 90 天,適用於 2 至 10 項的輪播。
輪播可否標示為 AI 生成?
可以,在輪播容器上使用 is_ai_generated。若設於項目上,會返回錯誤。
輪播可否包含 Reel?
不可以。Reel 必定單獨發布,而輪播項目只是一般的圖片或影片容器。
我的輪播為何因 2207028 失敗?
Meta 的訊息寫明輪播至少需要 2 個、不得超過 10 個項目。介乎 2 至 10 項之間的數目,同時符合該訊息及發布指南的 20 項上限,因此請調整項目,然後重新建立輪播容器。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期