API で Facebook ページに動画を投稿する
動画は POST /{page-id}/videos で Facebook ページに届きます。file_url を使って Meta が URL から直接取得する方法と、アプリが先に Meta へアップロードしたファイルを使う方法があります。title は動画の名前、description は Meta が投稿とともに表示する可能性のある文章です。その後 Meta がファイルを処理し、GET /{video-id}?fields=status で video_status が ready になるまで processing と返されます。
easyCoexistence は、Claude、ChatGPT、または独自のコードから publish_facebook_post で Facebook ページに動画を投稿できます。
Meta が file_url で指定された URL から動画ファイルを取得できない場合のエラーコード。
アップロードするには小さすぎる動画ファイルのエラーコード。Meta はより大きなファイルを求めます。
videos エッジの scheduled_publish_time の設定可能範囲。動画が公開された時点から数えます。
processing_progress の値の範囲。動画の処理がどこまで完了したかの割合で、video_status と並んで返されます。
動画アップロード用のホスト。Meta の Video API 概要では、graph-video.facebook.com が動画用途では非推奨とされています。
アップロードが返すファイルハンドル。/{page-id}/videos に fbuploader_video_file_chunk として渡し、動画を公開します。
動画はどのように Facebook ページに投稿されますか?
ページアクセストークンを使い、POST /{page-id}/videos を送信します。ファイルが Meta に届く方法は 2 通りあります。file_url は Meta 自身が取得するアクセス可能な動画の URL です。もう一つはアップロードで、アプリが先にバイトデータを送信します。file_url は、チャンク形式のアップロードのパラメータである upload_phase と併用できないため、1 つのリクエストではどちらか一方の方法を使います。
| file_url | Uploaded file | |
|---|---|---|
| Where the video is | At a URL Meta can reach | On your own system |
| On /{page-id}/videos | file_url | fbuploader_video_file_chunk with the upload's handle |
| Before publishing | Nothing: Meta fetches the file | An upload session, then the bytes |
| If it fails | Error 389 when Meta cannot fetch it | Resume from the offset Meta reports |
オンラインにないファイルはどのようにアップロードしますか?
Meta の動画投稿ガイドでは Resumable Upload API を使います。POST /{app-id}/uploads に file_name、file_length、file_type を送るとセッションが開始され、file_offset ヘッダーとバイトデータを付けて POST /upload:{session-id} を送ると、ハンドル h が返されます。その後、POST /{page-id}/videos に fbuploader_video_file_chunk としてそのハンドルを設定し、title と description と一緒に送って動画を公開します。これらのアップロード呼び出しにはユーザーアクセストークンを使います。
- 中断されたアップロードは、GET /upload:{session-id} が返す
file_offsetから再開します。 - videos リファレンスには、同じエッジ上のチャンク形式アップロードも記載されています。
upload_phaseは start、transfer、finish を指定し、start_offset、file_size、video_file_chunkを使います。
title と description は何をしますか?
title は動画のタイトルです。description は、Meta の説明によれば、動画に関するストーリーで表示される可能性のある投稿の説明文です。そのため、投稿の文章をここに入れます。どちらも videos エッジではオプションです。publish_facebook_post は、そのメッセージを description として送り、title は設定しません。
動画の準備ができたことはどう確認しますか?
Meta は動画が届いた後にそれを処理します。GET /{video-id}?fields=status は video_status を返します。値は、Meta が処理している間は processing、動画がアップロードされ、エンコードされ、サムネイルが作成されると ready、処理が失敗した場合は error です。processing_progress は 0 から 100 までの完了割合を示します。Meta は videos フィールドのページの Webhook を通じて投稿状況を通知することもできますが、EasyCoexistence はこれを購読していません。
動画のサイズと長さはどのくらいまで可能ですか?
ページの videos リファレンスと Meta の動画投稿ガイドには、最大ファイルサイズや長さの記載はありません。記載されているサイズ制限は、アップロードするには小さすぎるファイル向けのエラー 382 だけです。Meta のリールとストーリーのガイドでは、それぞれ独自の長さを定めています。リールは 3 秒から 90 秒、動画ストーリーは最大 60 秒です。EasyCoexistence は動画を予約するとき、その時点でファイルをコピーし、1 GB を超えるファイルは受け付けません。
必要な権限とページのタスクは何ですか?
videos リファレンスと投稿ガイドによれば、pages_manage_posts、pages_read_engagement、pages_show_list が必要で、CREATE_CONTENT タスクを実行できる人のページトークンを使います。Meta の Video API 概要では、より厳密に説明されています。その人は、ページに対する管理者相当の操作を行えるか、Business Manager を通じて付与された管理者ロールを持っている必要があります。
動画の投稿でどのようなエラーが返される可能性がありますか?
Meta の videos リファレンスには、POST /{page-id}/videos で返されるエラーが次のとおり記載されています。
- 389: URL から動画ファイルを取得できません。
- 382: 動画ファイルが小さすぎます。より大きいファイルで再試行してください。
- 6000: 動画ファイルのアップロードで問題が発生しました。別のファイルで再試行してください。
- 6001: 動画のアップロードで問題が発生しました。再試行してください。
- 368: 操作が不正行為とみなされたか、ほかの理由で許可されていません。
- 100: 無効なパラメーター。200: 権限エラー。190: 無効な OAuth 2.0 アクセストークン。
publish_facebook_post は動画をどのように投稿しますか?
video_url(ファイルへの公開 HTTPS リンク)と message を受け取り、file_url と description として /{page-id}/videos に送るため、Meta が動画を直接取得します。1 つの投稿には動画が 1 つだけ含まれ、動画と一緒に送られたリンクは拒否されるため、URL は message に入れてください。結果の post_id には Meta が返した ID が入ります。動画の場合、それは動画自身の ID です。
動画投稿はどのように予約しますか?
publish_facebook_post の scheduled_at に、タイムゾーン付きの ISO 8601 形式で日時を指定します。指定できるのは、今から 1 分後から 90 日後までです。EasyCoexistence は投稿を予約した時点で動画をコピーし、その時刻にページへ公開します。list_scheduled_posts で確認、update_scheduled_post で日時や本文を変更、cancel_scheduled_post で取り消せます。Meta 自身の videos エッジの scheduled_publish_time は、10 分から 6 か月まで指定できます。
よくある間違い
- file_url を、動画を再生するページではなく、動画ファイルそのものに向けてしまうこと。Meta はそのアドレスを自分で取得するため、取得できないと 389 エラーで失敗します。
- graph-video.facebook.com にアップロードすること。Meta の Video API 概要では、動画アップロード用としてこのホストは非推奨とされ、graph.facebook.com を使うよう求めています。
- 動画の準備ができる前に公開を知らせること。公開の呼び出しが返った後も処理は続くため、video_status が ready になるまでステータスを確認してください。
- 動画と一緒にリンクを送ること。publish_facebook_post はファイルと一緒のリンクを拒否します。代わりに URL を message に書いてください。
即時でも、最大 90 日先までの予約でも可能です。プラットフォームでは、Partner API の POST /channels/:id/posts で同じことができます。接続ごとに月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。
よくある質問
パソコンから Facebook ページに API 経由で動画をアップロードできますか?
はい。Meta の Resumable Upload API を使うと、/{page-id}/videos 用のハンドルが返されます。また、そのエッジのチャンク形式アップロードも利用できます。publish_facebook_post は代わりに公開 HTTPS URL を受け取るため、先にファイルをホストしてください。
動画をページのフィードに表示せずにアップロードできますか?
はい。published を false にすると投稿は保留され、no_story はフィードとタイムラインのストーリーを表示させず、secret を指定すると動画は Facebook 上に公開されず、検索にも出なくなります。
1 本の動画を複数のページに投稿できますか?
はい。クロスポストを使えます。公開済みの動画を、その人が管理する他のページにもう一度アップロードせずに投稿でき、各ページで個別の動画 ID が付きます。
EasyCoexistence の Facebook ページ向けの料金はいくらですか?
接続ごとに月額 US$ 9 から US$ 0.75 まで、接続の総数に応じて決まります。最初の 3 日間は無料です。Facebook ページ 1 つが 1 接続です。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日