Facebook Page のストーリーズを API で投稿
Meta の Stories API は、写真と動画のストーリーズを Facebook Page に投稿します。写真のストーリーは、published を false に設定してアップロードした写真の photo_id を使い、POST /{page-id}/photo_stories を呼び出して投稿します。動画のストーリーは、/{page-id}/video_stories に対する start、upload、finish の 3 つの呼び出しで投稿します。動画のストーリーは最長 60 秒、写真は 10 MB までです。
easyCoexistence は、Claude、ChatGPT、またはご自身のコードから publish_facebook_post で Facebook の Page の投稿を公開します。
Meta が Facebook Page で許可する動画ストーリーの最長時間。
写真ストーリーに使える最大の写真ファイル。JPEG、BMP、PNG、GIF、TIFF のいずれか。
動画ストーリーのアスペクト比。1080 x 1920 ピクセルを推奨、540 x 960 ピクセル以上。
GET /{page-id}/stories が報告するステータス。アーカイブ済みのストーリーズは、Page のストーリーズアーカイブを有効にしている場合にのみ表示されます。
写真ストーリーはどのように投稿しますか?
2 回の呼び出しで行います。published を false に設定して POST /{page-id}/photos に写真をアップロードすると、写真の ID が返されます。次に、photo_id にその ID を指定して POST /{page-id}/photo_stories を送信します。Meta は success に true を、ストーリー投稿の ID である post_id を返します。
POST /{page-id}/photo_stories
{
"photo_id": "<PHOTO_ID>"
}
200 OK
{
"success": true,
"post_id": "<STORY_POST_ID>"
}動画ストーリーはどのように投稿しますか?
3 つのステップで行います。Reel と同じ流れです。upload_phase を start に設定して POST /{page-id}/video_stories を送信すると、video_id と rupload.facebook.com 上の upload_url が返されます。動画は、ファイルのバイト列を offset と file_size ヘッダーとともに送るか、ホストされたファイルの場合は file_url ヘッダーを使って、その URL に送信します。最後に、video_id と upload_phase を finish に設定して POST /{page-id}/video_stories を送信すると、ストーリーが投稿され、post_id が返されます。
ストーリーにはどのメディアを使えますか?
Meta のストーリーズガイドには、写真と動画それぞれの仕様が記載されています。写真は、10 MB 以下の .jpeg、.bmp、.png、.gif、.tiff ファイルです。PNG は 1 MB 未満に抑えるのが望ましいです。動画は Reel の仕様に従いますが、上限時間がより短くなっています。
- ファイル:推奨は .mp4、アスペクト比は 9 x 16。
- 解像度:1080 x 1920 ピクセルを推奨、540 x 960 ピクセル以上。
- フレームレート:毎秒 24 から 60 フレームの固定値、プログレッシブスキャン。
- 長さ:動画ストーリーは最長 60 秒。
- コーデック:H.264 または H.265。VP9 と AV1 もサポートしています。音声は AAC Low Complexity、48 kHz、ステレオ、128 kbps 以上。
どのメディアはストーリーに使えませんか?
すでに公開済みの投稿で使われた写真や動画は使えません。Meta の規則では、ストーリー用にアップロードするメディアは、以前の投稿で使われたものであってはなりません。ホストされた動画は到達可能である必要があります。Meta は、robots.txt で facebookexternalhit/1.1 ユーザーエージェントをブロックしているサイトのファイルや、fbcdn の URL など Meta 独自の CDN 上のファイルを拒否します。
Page のストーリーズを一覧表示するには?
GET /{page-id}/stories は、ストーリーごとに 1 つのオブジェクトを返します。一覧は status で絞り込むか、since と until で日付を指定して絞り込めます。各オブジェクトには次の情報が含まれます:
post_id:ストーリー投稿の ID。- status:PUBLISHED または ARCHIVED。アーカイブ済みのストーリーズは、Page のストーリーズアーカイブを有効にする必要があります。
creation_time:ストーリーが公開された UNIX タイムスタンプ。media_typeとmedia_id:写真または動画の種類と、そのメディアの ID。- url:ストーリーの Facebook アドレス。facebook.com/stories/ 以下にあります。
必要な権限は何ですか?
Facebook Login または Facebook Login for Business を通じて、Page 上で CREATE_CONTENT タスクを実行できるユーザーから取得した Page トークンが必要です。pages_manage_posts、pages_read_engagement、pages_show_list の各権限が付与されている必要があります。ビジネスシステムユーザーとして行うリクエストには、business_management も必要です。これらは、Page のフィードへの投稿に必要なものと同じ 3 つの権限です。
ストーリーはいつ公開されますか?
photo_stories の呼び出し、または video_stories の finish 呼び出しが行われた時点で公開されます。Meta のストーリーズ API には公開時刻の指定がありません。photo_stories は photo_id を受け取り、finish 呼び出しは video_id、upload_phase、任意の is_ai_generated フラグを受け取ります。後日公開するストーリーは、その時点で呼び出しを行う必要があり、それにはご自身のスケジューラーを使います。
EasyCoexistence を使ってストーリーズを投稿するには?
まだできません。publish_facebook_post は、ストーリーではなく投稿を公開します。また、easyCoexistence には photo_stories や video_stories 用のツールがありません。Page トークンは提供されないため、その接続に対してご自身のコードから呼び出しを実行することもできません。ストーリーは Facebook または Meta Business Suite から公開してください。
よくある間違い
- 前の投稿で使った写真を再利用すること。ストーリー用のメディアは、以前に公開された投稿から用意することはできません。published を false に設定して、もう一度アップロードしてください。
- 90 秒の Reel をストーリーとして使おうとすること。Reel は 90 秒まで可能ですが、動画ストーリーは 60 秒までです。
- アーカイブ済みのストーリーズが一覧に出ると期待すること。GET /{page-id}/stories に表示されるのは、Page のストーリーズアーカイブを有効にしている場合のみです。
- 動画を graph.facebook.com に送信すること。アップロードは rupload.facebook.com の upload_url に対して行う必要があります。start、finish、ステータス確認の呼び出しは graph.facebook.com に残します。
テキスト、リンク、写真、動画に対応しています。Stories API 用のツールはないため、ストーリーは Facebook または Meta Business Suite から公開します。接続ごとの料金は月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。最初の 3 日間は無料です。
よくある質問
Reel を Facebook Page のストーリーとして共有できますか?
はい、60 秒以下であれば可能です。Meta の仕様では、Page でストーリーとして公開する Reel は、その長さを超えることはできません。
動画ストーリーに AI 生成であることを表示できますか?
はい。video_stories の finish 呼び出しで is_ai_generated を true に設定してください。既定値は false です。
ストーリーの動画アップロードが中断された場合はどうしますか?
offset を 0 に設定して再送し最初からやり直すか、ステータス確認で得た bytes_transfered の値を offset に設定して再開してください。
Facebook Page 向けの EasyCoexistence の料金はいくらですか?
接続ごとに月額 US$ 9 から US$ 0.75 まで、最初の 3 日間は無料です。各 Page が 1 つの接続となり、接続を増やすほど接続あたりの料金が下がります。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日