ログイン無料トライアルを開始
easyCoexistence 公式 API

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 件の写真と動画のカルーセルを公開します。

Up to 20

Meta の公開ガイドと children パラメーターで、カルーセルに含められる写真と動画の数。

2207028

コード 100 の下のサブコード。メッセージには、カルーセルには 2 から 10 件のアイテムが必要とまだ書かれています。

1 post

24 時間に API で公開できる投稿 100 件の上限に対して、カルーセルが何件として数えられるか。

1:1

カルーセル画像の既定の切り抜き。すべて最初の画像のアスペクト比に従います。

0

カルーセル内の個々の写真と動画について Meta が返すインサイト。

カルーセルはどのように公開しますか?

3 つの段階で行い、すべて POST /<IG_ID>/media と、公開用の呼び出し 1 回で完了します。

  • アイテム: 写真ごとに image_url、動画ごとに media_type VIDEO と 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 はカルーセル内のメディアについて何も返さず、投稿についてのみ返します。
EasyCoexistence で実現する

アイテムとキャプションを指定して 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 監視

確認日