Instagram メディアコンテナのステータス:コードとライフサイクル
Instagram の API は、メディアコンテナを通じて投稿を公開します。各コンテナは status_code を返し、その値は公開処理の段階を示します。IN_PROGRESS は公開処理中、FINISHED は公開可能な状態、PUBLISHED は公開済み、ERROR は公開処理を完了できなかったこと、EXPIRED は 24 時間以内に公開されなかったことを表します。Meta は、1 分ごとに確認し、確認は最長 5 分までにすることを推奨しています。
easyCoexistence は、publish_instagram_post の中でコンテナのサイクルを実行します。
status_code が取りうる値:IN_PROGRESS、FINISHED、PUBLISHED、ERROR、EXPIRED。
コンテナが公開されないまま待機できる時間。その後ステータスは EXPIRED になります。
Meta が推奨するステータス確認の間隔。最長 5 分まで。
直近 24 時間にアカウントが作成できるコンテナの数。
コード 9007 の下にあるエラーサブコード。まだ準備ができていないコンテナを公開しようとした場合に返されます。
メディアコンテナとは何ですか?
投稿の元になるオブジェクトです。POST /<IG_ID>/media に画像または動画の URL を送ると、Meta がメディアを取得して準備します。その後 POST /<IG_ID>/media_publish に、コンテナの ID を creation_id として渡すと、投稿として公開されます。カルーセルでは、アイテムごとにコンテナを 1 つ作成し、それらを子要素として一覧にする CAROUSEL コンテナを 1 つ追加します。
各ステータスコードは何を意味しますか?
GET /<IG_CONTAINER_ID>?fields=status_code は 5 つの値のいずれかを返します。それぞれに次の手順があります:
IN_PROGRESS:コンテナはまだ公開処理中です。待ってから、もう一度確認してください。- FINISHED:コンテナとメディアの準備ができています。公開してください。
- PUBLISHED:メディアはすでに公開されています。公開する作業はありません。
- ERROR:コンテナが公開処理を完了できませんでした。status フィールドにはその理由を示すエラーサブコードが入ります。新しいコンテナが必要です。
- EXPIRED:24 時間以内に公開されませんでした。新しく作成してください。
GET https://graph.instagram.com/<IG_CONTAINER_ID>?fields=status_code
{
"status_code": "FINISHED",
"id": "<IG_CONTAINER_ID>"
}ステータスはどのくらいの頻度で確認すべきですか?
Meta の推奨は、1 分ごとに、最長 5 分まで確認することです。特に動画で確認が重要です。Meta によると、動画のアップロードは非同期のため、コンテナ ID を受け取っただけではアップロードの成功は保証されません。status_code が FINISHED になることで、それを確認できます。
公開が早すぎるとどうなりますか?
media_publish は、コード 9007、サブコード 2207027 で失敗します。これは、メディアがまだ公開できる状態にないことを意味します。リクエストに修正は不要です。ステータスを確認し、FINISHED になってから公開してください。コード 24 とサブコード 2207008 は別の問題で、コンテナが存在しないか、期限切れであることを示します。Meta は、30 秒から 2 分の間に 1 回か 2 回再試行してから、新しいコンテナを作成することを推奨しています。
コンテナはどのくらいの期間有効ですか?
24 時間です。その時間内に公開されなかったコンテナのステータスは EXPIRED になり、もう公開できません。コード -2 とサブコード 2207020(メディアの期限切れ)も、新しいコンテナが必要であることを示します。アカウントは直近 24 時間に 400 個のコンテナを作成できるため、失敗後に作り直す余裕が残ります。
コンテナはほかに何を返しますか?
ほかに 2 つのフィールドと、公開時の注意点があります。status_code が ERROR の場合は、status にエラーサブコードが入ります。copyright_check_status は、動画について、Meta の著作権チェックが実行されたかどうか、また一致が見つかったかどうかを示します。公開後、キャプションやユーザーのタグ付けなしで投稿が公開された場合、media_publish は config_issue、CAPTION_NOT_ATTACHED、USER_TAGGING_FAILURE を返すことがあります。
よくある間違い
- コンテナ ID をアップロード完了と見なすこと。動画のアップロードは非同期で、status_code が FINISHED になって初めて、メディアの準備ができたと確認できます。
- status_code が IN_PROGRESS のまま公開すること。FINISHED になるまで、サブコード 2207027 で呼び出しが失敗します。
- コンテナを 1 日以上放置すること。24 時間公開されないと EXPIRED になり、新しいコンテナだけが公開できます。
- 失敗時に status_code だけを確認すること。ERROR の場合、status フィールドには原因を示すエラーサブコードが入っています。
コンテナを作成し、Instagram の処理完了を待ってから公開します。動画の処理がまだ続いている間は、自動的に公開まで完了します。Claude、ChatGPT、独自のコードは、公開済みのメディア ID か、easyCoexistence が完了させるまでの処理ステータスを受け取ります。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
Instagram のコンテナで IN_PROGRESS は何を意味しますか?
Meta がまだメディアを準備中です。待ってからもう一度確認してください。FINISHED になる前に公開すると、コード 9007 で失敗します。
Instagram アカウントは何個のメディアコンテナを作成できますか?
直近 24 時間に 400 個です。失敗後にコンテナを作り直す余裕が残ります。
公開後の config_issue は何を意味しますか?
media_publish は成功していますが、キャプションなし(CAPTION_NOT_ATTACHED)、またはユーザーのタグなし(USER_TAGGING_FAILURE)で投稿が公開されました。
コンテナが ERROR で終わったのはなぜですか?
公開処理を完了できなかったためです。status フィールドに原因を示すエラーサブコードが入っているので、その原因を解消してから新しいコンテナを作成してください。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日