ログイン無料トライアルを開始
easyCoexistence 公式 API

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 の投稿を公開します。

60 seconds

Meta が Facebook Page で許可する動画ストーリーの最長時間。

10 MB

写真ストーリーに使える最大の写真ファイル。JPEG、BMP、PNG、GIF、TIFF のいずれか。

9 x 16

動画ストーリーのアスペクト比。1080 x 1920 ピクセルを推奨、540 x 960 ピクセル以上。

PUBLISHED, ARCHIVED

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 を返します。

Publishing a photo story
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 が返されます。

1StartPOST /{page-id}/video_stories, upload_phase start
2UploadThe bytes or a file_url, sent to the upload_url
3StatusGET /{video-id}?fields=status
4Finishupload_phase finish with video_id: returns 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 に残します。
EasyCoexistence で実現する

テキスト、リンク、写真、動画に対応しています。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 監視

確認日