Instagram APIでカルーセル投稿を公開する
Instagram APIでは、カルーセルは Meta の公開ガイドに基づき、最大 20 枚の写真と動画をまとめた 1 件の投稿として公開されます。エラーリファレンスには今も 10 と書かれています。各アイテムは is_carousel_item を true に設定したコンテナとして個別に作成し、その後 CAROUSEL コンテナが子要素としてそれらを参照し、キャプションを持ちます。このコンテナを公開すると全体が一度に投稿され、24 時間で API から公開できる 100 件の投稿のうち 1 件として数えられます。
easyCoexistence は、Claude、ChatGPT、または独自のコードから publish_instagram_post を使い、2 から 10 件の写真と動画のカルーセルを公開します。
Meta の公開ガイドと children パラメーターで、カルーセルに含められる写真と動画の数。
コード 100 の下のサブコード。メッセージには、カルーセルには 2 から 10 件のアイテムが必要とまだ書かれています。
24 時間に API で公開できる投稿 100 件の上限に対して、カルーセルが何件として数えられるか。
カルーセル画像の既定の切り抜き。すべて最初の画像のアスペクト比に従います。
カルーセル内の個々の写真と動画について Meta が返すインサイト。
カルーセルはどのように公開しますか?
3 つの段階で行い、すべて POST /<IG_ID>/media と、公開用の呼び出し 1 回で完了します。
- アイテム: 写真ごとに
image_url、動画ごとにmedia_typeVIDEO とvideo_urlを指定してコンテナを作成します。is_carousel_itemは true に設定し、キャプションは付けません。 - カルーセル:
media_typeに CAROUSEL を指定し、children にアイテムのコンテナ ID をカンマ区切りで指定し、キャプションを設定してコンテナを作成します。 - 公開:
creation_idにカルーセルのコンテナ ID を指定して POST /<IG_ID>/media_publishを呼び出します。
カルーセルには何件のアイテムを入れられますか?
最大 20 件です。Meta の公開ガイドと POST /<IG_ID>/media の children パラメーターはどちらも、画像、動画、またはその混在で 20 件を上限としています。エラーリファレンスには古い書き方が残っています。コード 100、サブコード 2207028 のメッセージは、カルーセルには最低 2 件、最大 10 件のアイテムが必要と書いています。そのため、Meta のドキュメントのすべての箇所が受け入れる件数は 2 から 10 件です。アイテムは写真か動画にできますが、リールは不可です。カルーセルのアイテムは必ず画像または動画のコンテナです。
カルーセルの画像はどのように切り抜かれますか?
最初の画像に合わせて切り抜かれます。カルーセル内のすべての画像は最初の画像のアスペクト比に切り抜かれ、既定は 1:1 の正方形です。各画像は通常の条件も満たす必要があります。JPEG、8 MB 以下、アスペクト比 4:5 から 1.91:1 の間です。希望する形の画像を最初に配置するか、公開前にすべての画像の形をそろえてください。
カルーセルとアイテムのどちらに設定するものですか?
投稿レベルの設定の多くは、アイテムではなくカルーセルのコンテナに置きます。
- キャプション: カルーセルのコンテナのみに設定します。アイテムには設定できません。
- 位置情報: カルーセルのコンテナのみに設定します。
- AI 生成ラベル:
is_ai_generatedはカルーセルのコンテナに設定します。アイテムに設定するとエラーになります。 - 代替テキスト: 画像アイテムでサポートされ、それぞれ 1,000 文字まで指定できます。
カルーセルはどのように読み取られますか?
media_type が CAROUSEL_ALBUM の 1 つのメディアオブジェクトとして読み取られます。GET /<IG_MEDIA_ID>/children で中の写真と動画の一覧を取得できますが、permalink などの一部のフィールドは子要素では使えません。カルーセルのコメント数といいね数には子要素が含まれず、Meta は個々のアイテムのインサイトを返さず、カルーセル投稿のインサイトのみを返します。
カルーセルは上限にどのように数えられますか?
1 件の投稿として数えられます。アカウントは 24 時間の移動枠で API から 100 件の投稿を公開でき、カルーセルは何件のアイテムを含んでいても、そのうち 1 件を使います。ただし各アイテムは依然としてコンテナであり、アカウントは 24 時間の移動枠で 400 件のコンテナを作成できます。そのため、10 件のアイテムを持つカルーセルを連続して作ると、公開の上限より先にこの上限に達します。
よくある間違い
- アイテムにキャプションを付けること。カルーセルのアイテムではキャプションはサポートされていないため、カルーセルのコンテナに 1 回だけ設定してください。
- アイテムとしてリールを追加すること。カルーセルのアイテムは画像または動画のコンテナであり、リールをカルーセルに含めることはできません。
- 最初の写真を確認せずに縦と横の写真を混ぜること。すべての画像が最初の画像のアスペクト比になります。
- スライドごとのインサイトを期待すること。Meta はカルーセル内のメディアについて何も返さず、投稿についてのみ返します。
アイテムとキャプションを指定して 1 回呼び出すと投稿が公開され、動画の処理中であれば自動的に完了します。カルーセルは専用のキューからスケジュール予約することもできます。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
Instagram のカルーセルは API でスケジュール予約できますか?
はい。キューを通じて予約できます。Meta はコンテナを公開した時点でカルーセルを投稿するためです。easyCoexistence の publish_instagram_post は scheduled_at を受け付け、2 から 10 件のアイテムを持つカルーセルについて、1 分後から 90 日後までの予約ができます。
カルーセルを AI 生成として表示できますか?
はい。カルーセルのコンテナに is_ai_generated を設定します。アイテムに設定するとエラーになります。
カルーセルにリールを含めることはできますか?
いいえ。リールは常に単独で公開され、カルーセルのアイテムは通常の画像または動画のコンテナです。
カルーセルが 2207028 で失敗するのはなぜですか?
Meta のメッセージは、カルーセルには最低 2 件、最大 10 件のアイテムが必要と述べています。2 から 10 件の数はそのメッセージと、公開ガイドの上限 20 件の両方を満たします。アイテムを調整して、カルーセルのコンテナを作り直してください。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日