リファレンス

投稿

パス/{POST-id}

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

読み取り

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

アクセス許可

投稿ノードを読み取るには、グループコンテンツの読み取りアクセス許可が必要です。

フィールド

フィールド名説明型

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

with_tags

投稿のパブリッシャーが「含まれている」ことを示すタグが付けられたプロフィール。

Profileオブジェクトのリストが含まれているdataフィールドを持つJSONオブジェクト。

公開

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

削除

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

アクセス許可

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

更新

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

エッジ

エッジ名説明

/attachments

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

/comments

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

/likes

この投稿に「いいね！」した人。合計数を取得するsummaryフィールドがサポートされています。

/reactions

この投稿にリアクションした人。合計数を取得するsummaryフィールドがサポートされています。

/seen

この投稿を既読にした人。合計数を取得するsummaryフィールドがサポートされています。

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

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
  /{post-id}/comments?
  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}}