Workplace

Workplace from Metaは廃止されます。Workplaceは2025年8月31日まで今まで通りご利用いただけます。詳しくはヘルプセンターをご覧ください。

投稿

パス/{POST-id}

Workplace投稿を表します。/{post-id}ノードは単一の投稿を返します。

読み取り

グループ、イベント、またはユーザーのプロフィール内の投稿を表す単一のPostオブジェクトを返します。

アクセス許可

投稿ノードを読み取るには、グループコンテンツの読み取りアクセス許可が必要です。ユーザーのプロフィール内の投稿を読み取るには、ユーザータイムラインの読み取りアクセス許可が必要です。

フィールド

フィールド名説明型

id

{group-id}_{id}形式の投稿ID。

string

created_time

投稿が最初に公開された日時。

datetime

formatting

投稿が書式マークアップ言語を使用して作成されたかどうかを示します。戻り値は、使用されたマークアップ言語を示します。Workplaceはマークダウンとプレーンテキストをサポートしています。

enum {MARKDOWN|PLAINTEXT}

from

メッセージを投稿した人またはプロフィールに関する情報。

Profile

icon

この投稿のタイプを表すアイコンへのリンク。

url

link

この投稿に添付されたリンク。

url

message

投稿に含まれるステータスメッセージ。

string

name

linkの名前(投稿に添付されている場合)。

string

object_id

投稿に添付された、アップロード済みの写真または動画のID。

string

permalink_url

投稿のパーマリンクページを示すURL。

url

picture

投稿に含まれている任意のlinkからスクレイピングされた写真。

url

place

投稿に添付された任意の位置情報。

Place

poll

投稿がアンケートの場合、このフィールドは添付のQuestionオブジェクトを返します。これにより、optionsとユーザーが行ったオプションvotesを確認できます。

Question

properties

添付された任意の動画のプロパティ(動画の長さなど)のリスト。

object[]

status_type

ステータスアップデートのタイプの説明。

enum {mobile_status_update, created_note, added_photos, added_video, shared_story, created_group, created_event, wall_post, app_created_story, published_story, tagged_in_photo}

story

ユーザーが意図的に生成したものではないストーリーのテキスト。

string

to

この投稿でメンションまたはターゲット設定されたプロフィール。

Profile[]

type

この投稿のオブジェクトタイプを示す文字列。

enum{link, status, photo, video}

updated_time

投稿が作成された日時、最後に編集された日時、または投稿に最後のコメントが残された日時。

datetime

公開

このエッジを使って公開することはできません。グループに新しい投稿を作成するには、/group/feedエッジを使用してください。

削除

グラフAPIを介して投稿を削除するには、パス/{post_id}でDELETEリクエストを実行します。

アクセス許可

投稿ノードを削除するには、グループへの投稿アクセス許可に加え、投稿が行われたグループに応じてすべてのコンテンツの読み取りアクセス許可またはオープンコンテンツのみの読み取りアクセス許可が必要です。

ユーザーのタイムラインから投稿を削除するには、ユーザーのタイムラインの管理アクセス許可が必要です。

更新

更新できるのはボットによって作成された投稿のみです。impersonate_tokenを持つユーザーの代理で作成された投稿は更新できません。投稿を編集するには、更新済みのmessageを本文中に指定して、/{post-id}エッジでPOSTリクエストを実行します。

エッジ

エッジ名説明

/attachments

この投稿に関連するすべてのメディア添付ファイル。

/comments

この投稿へのコメント。合計数を取得するためにsummaryフィールドがサポートされています。

/reactions

この投稿にリアクションした人。合計数を取得するためにsummaryフィールドがサポートされています。期間内のリアクション数を取得するためにsince=unix_timstampフィールドとuntil=unix_timestampフィールドもサポートされています。

/seen

この投稿を既読にした人。合計数を取得するためにsummaryフィールドがサポートされています。期間内の既読数を取得するためにsince=unix_timstampフィールドとuntil=unix_timestampフィールドもサポートされています。


この情報は、こちらで説明されているのと同じ制限に従うことにご注意ください

サポートされるマークダウン構文

Workplaceで投稿を公開する際は、次のマークダウン構文がサポートされます:

書式構文

太字

**Bold**

斜体

*Emphasize*

リンク

[Link](https://workplace.fb.com)

Inline code

`Inline code`
code block
``` code block ```
  • リスト
* List
  1. 番号付きリスト
1. Numbered list

引用

> Quote

見出し1

# Heading 1

見出し2

## Heading 2

例

投稿のID、source、storyを取得する

GET graph.facebook.com
  /{post-id}?fields=id,source,story

投稿からコメントを取得する

GET graph.facebook.com
  /{post-id}/comments

投稿の既読状態(合計数のサマリーを含む)を取得する

GET graph.facebook.com
  /{group-id}_{post-id}/seen?
  summary=true

グループに投稿する

POST graph.facebook.com
  /{group-id}/feed?
  message=Hello+World&
  link=https://developers.facebook.com/docs/workplace/custom-integrations/apps

グループ投稿でユーザーにタグを付ける

POST graph.facebook.com
  /{group-id}/feed?
  message=Hi+@[100013325822531]

マークダウン書式でグループに投稿する

POST graph.facebook.com
  /{group-id}/feed?
  message=This+is+a+**formatted**+*post*&
  formatting=MARKDOWN

フィールド拡張機能を使用して、アンケート投稿のアンケート質問オプションと投票を読み取る

GET graph.facebook.com
  /{post-id}?
  fields=message,poll{options{name,vote_count,votes}}

投稿を削除する

DELETE graph.facebook.com
  /{post-id}

期間内のリアクション/既読を取得する

GET graph.facebook.com
  /{post-id}/seen?
        since=1577836800&
        until=1593561600