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

Facebook ページへの写真投稿: 1 枚と複数枚の投稿

写真は POST /{page-id}/photos で Facebook ページに届きます。url にはネット上に既にある画像の URL を設定するか、ファイルを multipart/form-data として添付し、caption にテキストを入れます。複数枚の写真は、それぞれ published を false にしてアップロードし、返された ID を media_fbid として attached_media に並べ、POST /{page-id}/feed に送ると 1 つの投稿になります。

easyCoexistence は、Claude、ChatGPT、または独自のコードから publish_facebook_post で Facebook ページに写真を投稿します。

10 MB

photos エッジが受け付ける最大の写真ファイルサイズ。Meta は、ピクセル化を避けるため PNG ファイルを 1 MB 未満に抑えることを勧めています。

About 24 hours

未公開の写真が Meta のサーバーに残る期間。その期間内に公開されなかった写真は削除されます。

324

写真エッジで、画像ファイルが見つからない、または無効な場合に返されるエラーコード。

temporary

スケジュール投稿における写真のパラメータ。published は false にする必要があり、写真自体には scheduled_publish_time を設定しません。

post_id

写真が公開されると、写真の id と一緒に返される値で、その写真を含むページ投稿の ID です。

写真を 1 枚ページに投稿するにはどうすればよいですか?

url にインターネット上の既存の写真 URL を設定して POST /{page-id}/photos に送るか、ファイルを multipart/form-data として添付します。添付フィールドは以前 source と呼ばれていました。caption は写真のテキストで、絵文字に対応しています。Meta は 2 つの ID を返します。写真の id と、それを含むページ投稿の post_id です。

Publishing a photo from a URL
POST /{page-id}/photos
{
  "url": "https://example.com/flyer.jpg",
  "caption": "Doors open at 9 on Saturday."
}

200 OK
{
  "id": "<PHOTO_ID>",
  "post_id": "<PAGE_POST_ID>"
}

Meta が文書化している写真のパラメータは何ですか?

url と caption のほかに、写真の公開方法を決めるオプションが次のとおり用意されています。

  • published: 既定値は true です。false にすると、公開せずに写真をアップロードします。
  • no_story: true にすると、アプリが写真をアップロードした際に Meta が自動生成するフィードストーリーを表示しません。
  • alt_text_custom: 画像のアクセシブルな代替説明文です。
  • scheduled_publish_time: 未公開の写真投稿を公開する時刻です。ページのみで使用できます。
  • place: 位置情報に使うページの ID です。backdated_time は、より前の作成時刻を設定します。
  • message: 非推奨とされており、代わりに caption を使います。

Meta はどの画像ファイルを受け付けますか?

JPEG、BMP、PNG、GIF、TIFF で、1 ファイル最大 10 MB です。Meta は PNG ファイルを 1 MB 未満に抑えることを推奨しています。大きいファイルはピクセル化して見える場合があるためです。公開前に Facebook は画像から位置情報メタデータを削除し、表示用にいくつかのサイズへリサイズします。ファイルが無い、または読み取れない場合はエラー 324 で失敗します。

複数枚の写真を 1 つの投稿にするにはどうすればよいですか?

2 段階で行います。まず、POST /{page-id}/photos に published を false にして写真を 1 枚ずつアップロードします。これで投稿はされず、ID が返されます。次に、message と attached_media を付けて POST /{page-id}/feed に送ります。attached_media には写真ごとに media_fbid を 1 つずつ指定します。Meta は、写真をまとめて表示する 1 件の投稿の ID を返します。未公開の写真は Meta のサーバーに約 24 時間残るため、その期間内にフィードへの呼び出しを行ってください。

1UploadPOST /{page-id}/photos with url and published false, once per photo
2CollectKeep the id each upload returns
3PostPOST /{page-id}/feed with message and attached_media
4ResultOne Page post ID for the photos together

複数枚の投稿はどのようにスケジュールされますか?

Meta 自身のスケジュール機能を使います。写真は published を false、temporary を true にしてアップロードします。次に、フィード呼び出しで published を false、scheduled_publish_time を指定し、unpublished_content_type を SCHEDULED に設定します。Meta の Pages ガイドでは、公開時刻をリクエストの 10 分後から 30 日後までの間に設定するとされており、Meta はその時刻まで投稿を保持します。

publish_facebook_post は写真に何を受け取りますか?

account_id、image_url、そして 1 枚の画像への公開 HTTPS リンク、および投稿のテキストである message です。投稿には画像を 1 枚だけ含められ、一緒に渡されたリンクは拒否されるため、URL は message に含めてください。scheduled_at を省略すると写真はすぐに投稿されます。指定する場合は、1 分後から 90 日後までの ISO 8601 形式(タイムゾーン付き)で指定します。easyCoexistence は投稿をスケジュールした時点で画像をコピーし、その時刻に公開します。Facebook の写真の 10 MB 制限は引き続き適用されますが、コピー処理では最大 30 MB の画像を受け付けます。

easyCoexistence で複数枚の写真を投稿するにはどうすればよいですか?

まだできません。publish_facebook_post が受け取る image_url は 1 つだけで、easyCoexistence には、Meta が文書化している 2 段階の呼び出しに使えるツールがありません。その呼び出しとは、画像 1 枚につき 1 回、url と published を false にして <PAGE_ID>/photos に POST し、返された ID をまとめて <PAGE_ID>/feed に投稿するものです。アルバムは Facebook または Meta Business Suite で投稿するか、写真を個別の投稿として公開してください。

よくある間違い

  • 複数枚の写真を 1 回ずつ呼び出して投稿すること。published が true のままだと、/photos への呼び出しごとに個別の投稿が作られます。未公開でアップロードし、1 つのフィード投稿に添付してください。
  • 未公開の写真を添付するまでに 1 日以上待つこと。Meta は約 24 時間保持し、その後削除します。
  • スケジュール投稿の写真で temporary を外したままにすること。Meta は、スケジュール投稿に添付する写真では、published を false、temporary を true にすることを求めています。
  • 投稿ではなく写真の id を編集すること。photos エッジは写真の id と、投稿の post_id を返します。テキストの変更は post_id に対して行ってください。
EasyCoexistence で実現する

今すぐでも、最大 90 日先までのスケジュールでも可能です。投稿ごとに写真は 1 枚で、複数枚の投稿は Facebook または Meta Business Suite で作成します。接続ごとに月額 US$ 9 から、接続を増やすほど下がって US$ 0.75 まで。最初の 3 日間は無料です。

よくある質問

Facebook の写真投稿に代替テキストを付けられますか?

はい。/{page-id}/photos の alt_text_custom で、画像のアクセシブルな説明を設定できます。publish_facebook_post にはこの項目がないため、写真を投稿した後に Facebook で説明を追加してください。

Facebook は写真の位置情報を保持しますか?

いいえ。Meta は公開前に位置情報メタデータを削除します。場所を表示するには、その場所を持つページの ID を place に設定してください。

1 枚の写真投稿をスケジュールできますか?

はい。scheduled_at を付けた publish_facebook_post は、easyCoexistence のキューに 1 分後から 90 日後まで保持されます。Meta 側では、published を false にして scheduled_publish_time を指定することでも、スケジュールできます。

Facebook ページの easyCoexistence の料金はいくらですか?

接続するページごとに 1 件の接続となり、接続数に応じて接続ごとに月額 US$ 9 から US$ 0.75 までです。最初の 3 日間は無料です。

続きを読む

最初のチャンネルを 2 分で接続しましょう。

プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。

  • 3 日間無料
  • いつでも解約可能
  • 公式 API のみ使用
  • 24/7 監視

確認日