Facebook Reels API:Facebook ページへのリール投稿
Facebook Reels API では、リールを 3 段階で Facebook ページに公開します。upload_phase を start にして POST /{page-id}/video_reels を送ると video_id が返ります。次に動画を rupload.facebook.com にアップロードし、upload_phase を finish、video_state を PUBLISHED にして POST /{page-id}/video_reels を送ると投稿されます。Meta の仕様は、3 秒から 90 秒の 9:16 の動画です。Facebook ページは API から 24 時間に 30 本までリールを公開できます。
easyCoexistence は、Claude、ChatGPT、またはご自身のコードから、publish_facebook_post で Facebook ページに動画を通常の動画投稿として投稿でき、テキスト、リンク、写真にも対応します。
API で公開されるリールの数は、24 時間の移動期間内で Facebook ページごとに制限されます。適用先は POST /{page_id}/video_reels です。
Meta が受け付けるリールの長さ。ストーリーとして Facebook ページに公開するリールは 60 秒を超えられません。
リールの最低解像度。Meta は 9 x 16 のアスペクト比で 1080 x 1920 ピクセルを推奨しています。
scheduled_publish_time で設定できる最も先の日時。少なくとも 10 分後で、video_state は SCHEDULED を指定します。
Facebook が対応していない長さのリールのエラーコード。リールは 3 秒から 90 秒である必要があります。
Reels API はどのようにリールを公開しますか?
2 つのホストにまたがる 3 段階で行います。start と finish の呼び出しは graph.facebook.com 上の Facebook ページの video_reels エッジに送り、動画本体は start の呼び出しが返す upload_url を使って rupload.facebook.com に送ります。アップロードと finish の間に、動画 ID でステータスを確認すると、Meta がファイル全体を受け取り処理を終えたかどうかが分かります。
リールにはどのような動画が必要ですか?
Meta はリールの仕様を Reels Publishing ガイドで公開しています。アスペクト比、解像度、長さ、フレームレートのいずれかが仕様に合わないアップロードは、独自のエラーコードとともに拒否されます。Facebook ページのストーリーとして公開するリールは、さらに 60 秒以内に収める必要があります。
動画はどのようにアップロードしますか?
rupload.facebook.com の upload_url に対して、Authorization: OAuth ヘッダーでページのトークンを付けて POST します。ローカルのファイルはリクエストボディとして送り、offset ヘッダーを 0 に、file_size ヘッダーをバイト単位のサイズに設定します。すでにオンラインにあるファイルは、代わりに file_url ヘッダーで指定します。Meta がそのファイルを取得し、成功すると success が true で返ります。
file_urlには http または https のアドレスを指定できます。認証が必要な URL には対応していません。- ホストは facebookexternalhit/1.1 のユーザーエージェントがファイルを取得できるようにしてください。robots.txt でこれをブロックしているサイトのファイルは、Meta が拒否します。
- fbcdn の URL など、Meta 自身の CDN 上のファイルは拒否されます。別のページで動画を再利用するには、クロスポストを使うよう Meta は案内しています。
# <UPLOAD_URL> is the upload_url the start call returned
curl -X POST "<UPLOAD_URL>" \
-H "Authorization: OAuth <PAGE_ACCESS_TOKEN>" \
-H "file_url: https://example.com/reel.mp4"リールのステータスはどう確認しますか?
graph.facebook.com で GET /{video-id}?fields=status を送ります。応答には video_status が含まれ、その値は uploading、upload_complete、processing、ready、upload_failed、expired、error のいずれかです。さらにフェーズごとのオブジェクトがあります。uploading_phase には bytes_transfered、processing_phase にはエラーメッセージがあればその内容、publishing_phase には publish_status(draft、scheduled、published、error のいずれか)と publish_time が入ります。各フェーズの状態は not_started、in_progress、completed、error のいずれかです。
中断されたアップロードはどう再開しますか?
アップロードの POST を再送し、offset ヘッダーには、ステータス確認で得た uploading_phase.bytes_transfered、つまり Meta がすでに受け取ったバイト数を設定します。Meta が受け付けない offset を指定すると OffsetInvalidError が、ファイルの長さと一致しないボディを送ると PartialRequestError が返ります。再アップロードがうまくいかない場合、Meta は最初の手順からやり直すよう案内しています。
finish の呼び出しには何を渡しますか?
start の呼び出しで得た video_id、upload_phase に finish、video_state に PUBLISHED、DRAFT、SCHEDULED のいずれかを指定します。description に本文を入れ、ハッシュタグにも対応しています。title、位置情報ページ向けの place、そして is_ai_generated は省略可能です。is_ai_generated は、リールが AI で作成または編集されたことを明示するものです。予約投稿のリールには、10 分より後で 29 日以内の UNIX タイムスタンプである scheduled_publish_time を追加します。Meta は success が true の応答を返します。
Facebook ページは API で何本のリールを公開できますか?
24 時間の移動期間内で 30 本です。Meta はリールの公開時に POST /{page_id}/video_reels で上限を適用し、特に投稿の予約を許可しているアプリでは、アプリ側でも上限を適用するよう推奨しています。共同編集者への招待には別の上限があり、Facebook ページごとに 24 時間で 10 件です。video_reels のリファレンスには、エラー 613(この API への呼び出しがレート制限を超えました)が記載されています。
どの権限と Facebook ページのタスクが必要ですか?
CREATE_CONTENT タスクを実行できる人物から発行されたページのアクセストークンで、Facebook ログインを通じて pages_show_list、pages_read_engagement、pages_manage_posts の権限が付与されている必要があります。Meta はアプリに対して、リールが Facebook でどのように使われるかの開示を、制御するための選択肢とともに本人に表示することも求めています。また、ページへの公開には暗黙に公開範囲が Public として扱われるため、公開範囲は Public のみを提供するよう求められています。
Reels API はどのエラーを返しますか?
コード 100 は必須パラメータが欠けていることを示し(upload_phase など)、Meta のメッセージには不足しているパラメータが列挙されます。仕様から外れる動画を拒否するコードはさらに 4 つあります:
- 1363040:アスペクト比に対応していません。動画は 16x9 から 9x16 の間である必要があります。
- 1363127:解像度に対応していません。最小は 540 x 960 ピクセルです。
- 1363128:長さに対応していません。リールは 3 秒から 90 秒である必要があります。
- 1363129:平均フレームレートに対応していません。リールは毎秒 24 から 60 フレームである必要があります。
Facebook ページのリールを一覧表示するには?
GET /{page-id}/video_reels を使います。公開済みのリールを ID、更新日時、説明とともに返します。since と until で一覧を絞り込めます。日付は today、yesterday、UNIX タイムスタンプ、または yyyy-mm-dd で指定し、until は since より後である必要があります。Meta のフィードのリファレンスは、ページに公開されたリールについてこのエッジを案内しています。
easyCoexistence でどのようにリールを公開しますか?
現時点では、Reel としては投稿できません。publish_facebook_post は、動画を通常の動画投稿として Facebook ページの videos エッジに送ります。easyCoexistence には video_reels の呼び出し用のツールがなく、ページのトークンは渡されないため、3 段階の処理をご自身のコードから接続上で実行することもできません。Reel は Facebook または Meta Business Suite から公開するか、動画を通常の動画投稿として投稿してください。
よくある間違い
- アップロードを graph.facebook.com に送ってしまう。動画は Authorization: OAuth ヘッダーを付けて rupload.facebook.com に送ります。graph.facebook.com を使うのは start、finish、ステータス確認の呼び出しだけです。
- Meta が取得できない場所にファイルを置いてしまう。ログインの背後にある file_url、robots.txt で facebookexternalhit/1.1 がブロックされているサイト、または fbcdn 上のファイルは拒否されます。
- 中断したアップロードを最初からやり直してしまう。まずステータスを確認してください。uploading_phase.bytes_transfered が再開するオフセットであり、新しいセッションは最後の手段です。
- 1 日に 1 つの Facebook ページで 30 本を超えるリールを予約する。Meta は 24 時間の移動期間内で API で公開されたリールを数えるため、予約投稿は時間をずらして分散させてください。
Reels API 用のツールはないため、Reel は Facebook または Meta Business Suite から公開します。料金は接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルとしてご利用いただけます。
よくある質問
Reels を API で Facebook の個人プロフィールやグループに公開できますか?
いいえ。Meta の Reels Publishing API はリールを Facebook ページに公開し、クロスポストもページ間でのみ行います。
publish_facebook_post でリールを公開できますか?
いいえ。テキスト、リンク、写真、動画を Facebook ページに投稿します。リールには video_reels の呼び出しが必要ですが、easyCoexistence のツールではそれを行いません。
リールの著作権の一致はどう確認しますか?
pages_read_engagement の権限で GET /{video-id}?fields=copyright_check_information を読み取ります。Meta はアップロード時にチェックを行い、数分かかることがあります。一致の内容はオーナーだけが見られます。
別のページでも私のリールを公開できますか?
はい、共同編集者として可能です。target_id に相手の Facebook ページの ID を設定して POST /{video-id}/collaborators を送ると招待が届き、相手が承諾すると、そのリールは相手のページにも表示されます。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日