Instagram のトライアルリールを API で公開:trial_params と昇格
Instagram の API では、最初は非フォロワーにのみ表示されるトライアルリールを、REELS コンテナーに trial_params を追加して公開できます。graduation_strategy で、リールがフォロワーに届く方法を設定します。MANUAL はアカウント所有者が Instagram アプリで手動で昇格させる設定、SS_PERFORMANCE は成績が良ければ自動的に昇格させる設定です。Meta は 2025 年 12 月から Instagram Login で対応しています。
easyCoexistence は、Claude、ChatGPT、または独自のコードから publish_instagram_post でリールを、通常どおりフォロワー向けに公開します。
Meta が Content Publishing API にトライアルリールを追加した時期。対象は Instagram Login と Facebook Login の両方。
MANUAL は Instagram アプリで手動で昇格、SS_PERFORMANCE はトライアルリールの成績が良ければ自動的に昇格。
trial_params を含むリクエストで必要な media_type。
リールコンテナーで扱える最長の動画の長さ。最短は 3 秒、最大ファイルサイズは 300 MB。
メディアコンテナーが公開されずに有効な期間。
トライアルリールとは何ですか?
アカウントをフォローしていない人にのみ Instagram が共有するリールです。昇格させると通常のリールとなり、フォロワーにも共有されます。昇格は、公開時に設定した戦略に応じて、アカウント所有者が Instagram アプリで選んだときに行われるか、成績が良ければ自動的に行われます。
API からどのように公開しますか?
通常のリールの呼び出しに、パラメータを 1 つ追加します。POST /<IG_ID>/media でコンテナーを作成し、media_type に REELS、video_url、キャプション、graduation_strategy を含む trial_params を指定します。コンテナーの status_code が FINISHED と表示されるまで待ち、POST /<IG_ID>/media_publish で、creation_id としてコンテナー ID を渡して公開します。
POST https://graph.instagram.com/v26.0/<IG_ID>/media
Content-Type: application/json
Authorization: Bearer <ACCESS_TOKEN>
{
"media_type": "REELS",
"video_url": "https://www.example.com/videos/reel.mp4",
"caption": "<CAPTION>",
"trial_params": { "graduation_strategy": "MANUAL" }
}どの昇格戦略を選ぶべきですか?
フォロワーに表示される前に誰かが結果を確認する場合は MANUAL を選びます。リールは Instagram アプリで手動で昇格されるまで、非フォロワーにのみ表示され続けます。判断を Instagram に任せられる場合は SS_PERFORMANCE を選びます。成績が良ければトライアルリールは自動的に昇格します。graduation_strategy は trial_params 内で必須で、指定できる値はこの 2 つだけです。
どのルールが引き続き適用されますか?
トライアルリールは、通常のリールと同じパラメータに trial_params を加えて作成されるため、リールのルールがそのまま適用されます。
- 動画: MOV または MP4、3 秒から 15 分、最大 300 MB、Meta が取得できる公開 URL にあること。
- 処理: Meta の推奨に従い、コンテナーの
status_codeが FINISHED になるまで 1 分ごとに、5 分を超えない範囲で確認します。 - 有効期限: 24 時間以内に公開されなかったコンテナーは期限切れとなり、作成し直す必要があります。
- キャプション: 最大 2,200 文字、@ タグ 20 個まで。ハッシュタグは Instagram の現行ルールに従い最大 5 個(Meta の API リファレンスでは依然として 30 と記載)。
- カルーセル: リールはカルーセルに含めることができません。
Instagram Login で動作しますか?
はい。Meta の変更履歴によると、2025 年 12 月 3 日に、Instagram API のトライアルリールが Instagram Login と Facebook Login の両方に対応しました。公開ガイドには graph.instagram.com に対する呼び出しが示されています。必要な権限は公開用のペアで、instagram_business_basic と instagram_business_content_publish です。
API でトライアルリールを昇格させることはできますか?
Meta は、トライアルリールが昇格する方法を 2 つ説明しています。MANUAL の場合は Instagram アプリで手動、SS_PERFORMANCE の場合は成績が良ければ自動です。公開ガイドとメディアリファレンスには、昇格のための API 呼び出しは記載されていません。そのため、API が担うのはトライアルリールの公開までです。
Claude や ChatGPT からトライアルリールを公開するには?
現時点では easyCoexistence を通じては行えません。publish_instagram_post はリールのコンテナー自体を作成し、trial_params を受け付けないため、公開されるリールは通常どおりフォロワーに配信されます。また、独自の呼び出しのために Instagram のトークンが発行されることもありません。トライアルリールは、Instagram アプリの共有画面にある「トライアル」スイッチをオンにして共有してください。
よくある間違い
- 写真、カルーセル、ストーリーズのコンテナーに trial_params を追加すること。Meta が受け付けるのは media_type が REELS の場合だけです。
- graduation_strategy を省略すること。MANUAL または SS_PERFORMANCE を trial_params 内で必ず指定する必要があります。
- 動画の処理が終わる前に公開すること。media_publish は、コンテナーの status_code が FINISHED になってからのみ成功します。
- トライアルリールを公開した時点でフォロワーに表示されると想定すること。昇格するまで非フォロワーにのみ表示されます。
このツールは trial_params を受け付けないため、トライアルリールは Instagram アプリから共有します。料金は、接続済みの番号 1 件あたり月額 US$ 9 から、番号を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
Instagram API でトライアルリールを公開できますか?
はい。REELS コンテナーに graduation_strategy 付きの trial_params を追加し、通常どおり公開します。Instagram Login または Facebook Login を使用します。
trial_params は写真やカルーセルに使えますか?
いいえ。Meta が trial_params を受け付けるのは media_type が REELS のコンテナーだけです。写真、カルーセル、ストーリーズのコンテナーはトライアル投稿にできません。
フォロワーにはトライアルリールが表示されますか?
最初は表示されません。トライアルリールは非フォロワーにのみ共有され、昇格するとフォロワーに届きます。
トライアルリールの長さに制限はありますか?
通常のリールと同じです。3 秒から 15 分、MOV または MP4 形式で 300 MB まで、Meta が取得できる公開 URL にあること。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日