日本語への翻訳がまだ完了していません。
Workplace from Metaは廃止されます。Workplaceは2025年8月31日まで今までどおりご利用いただけます。詳しくはヘルプセンターをご覧ください。
コミュニティ
パス/community
代替パス/company
Workplaceコミュニティを表します。/communityノード(または/company、置き換え可能)は、タイプがグループの単一コミュニティオブジェクトを返します。APIに関して便宜上、このルートコミュニティオブジェクトを、その他のグループやコミュニティのルートグループと考えることができます。
コミュニティIDは、カスタム統合アクセストークンを指定してgraph.facebook.com/communityに対するグラフAPIのGET呼び出しを実行することによって、調べることができます。
場合によっては、ルートコミュニティに他のコミュニティが含まれることもあります。それはルートコミュニティの/groupsエッジとして現れます。ルートコミュニティの子コミュニティは、is_communityフィールドにより子グループと区別できます。
ルートコミュニティの内部に1つ以上のコミュニティが存在するなら、そのWorkplaceインスタンスはコミュニティ対応です。
次いでそれらの子コミュニティの/groupsエッジでクエリを実行することにより、そのコミュニティ内のグループを取得することができます。いずれにしても、/groupsエッジで表示されるのは、そのコミュニティの直接の子だけであり、再帰的処理は実行されません。
コミュニティをAPIによって作成することはできませんが、メンバーの管理はグループのメンバーと同じ方法で管理できます。
公開
このノードを使用してWorkplaceコミュニティを公開することはできません。
削除
このノードを使用してWorkplaceコミュニティを削除することはできません。
更新
このノードを使用してWorkplaceコミュニティを更新することはできません。
エッジ
| 名前 | 説明 |
|---|---|
| このエッジは、Workplaceコミュニティの中のアカウントの作成/利用解除/削除を実行するために使用します。このエッジには、ユーザーアカウントのプロビジョニングのアクセス許可が必要です |
Workplaceコミュニティのシステム管理者。このエッジには、アカウントの管理のアクセス許可が必要です | |
| 使用可能なバッジのリスト |
| Workplaceコミュニティのイベント。 |
Workplaceコミュニティのうち、かつてはメンバーだったが現在はアカウントが利用解除されているメンバー。 | |
Workplaceコミュニティ内のグループとサブコミュニティ。 | |
| ルートレベルのカテゴリのリスト |
| 情報ライブラリ内のよく使用されるツールやその他のリソースのリンクのリスト |
Workplaceコミュニティのメンバー。 | |
| コミュニティ管理者による審査の対象となる、報告されたコンテンツのアイテムのリスト。このエッジは2019年4月30日に廃止されたことにご注意ください。 |
このコミュニティのメンバーのプロフィールに追加できるスキルのリスト。 |
例
新しいグループを作成する
Workplaceコミュニティの新しいグループは、/community/groupsエッジに対してPOSTリクエストを発行することによって作成できます。応答には、新たに作成されたグループのIDが含まれます。グループにメンバーが表示されるようにするには、少なくとも1つのメンバーを追加してそのメンバーを管理者にする必要があります。
POST graph.facebook.com
/community/groups?
name={...}&
description={...}&
privacy=OPENルートコミュニティのすべてのグループとコミュニティのリストを取得する。
GET graph.facebook.com
/community/groups?fields=is_communityルートコミュニティのすべてのメンバーのリストを取得する。
GET graph.facebook.com
/community/membersルートコミュニティのすべてのメンバーに対してexternal_idでフィルタ処理したメンバーのリストを取得する。
GET /community/members?
external_ids=12356,abc123コンテンツのアイテムを報告する(このエッジは2019年4月30日に廃止されたことに注意してください)。
POST graph.facebook.com
/community/reported_content?
content_id={...}新しいグループをルートコミュニティに追加する。
POST graph.facebook.com
/community/groups?
name={...}&
description={...}&
privacy=OPEN新しいグループをルート以外のコミュニティに追加する。
POST graph.facebook.com
/{community-id}/groups?
name={...}&
description={...}&
privacy=OPENアカウントをプロビジョニングする。
POST graph.facebook.com
/community/accounts?
name={...}&
email={...}&
department={...}&
division={...}&
organization={...}&
title={...}&
manager={...}&
hire_date={...}&
invite={...}&
active={...}アカウントに更新を加えるには、仕事用プロフィールの管理のアクセス許可が必要であり、かつ以下のエンドポイントを使用しなければなりません
POST /{member-id}詳しくは、「アカウント管理」のページをご覧ください。
使用可能なバッジのリストを出力する。
これには、バッジを管理のアクセス許可が必要です
GET graph.facebook.com
/community/badges?fields=id,name,description,icon,categoryルートレベルのカテゴリのリストを出力する。
これには情報ライブラリコンテンツの読み取りのアクセス許可が必要です
GET graph.facebook.com
/community/knowledge_library_categories新しいルートレベルカテゴリを公開する。
これには、情報ライブラリコンテンツの管理のアクセス許可が必要です。各フィールドの値について詳しくは、こちらをご覧ください。
POST graph.facebook.com
/community/knowledge_library_categories?
title={...}&
icon={...}&
color={...}&
json_content={...}情報ライブラリ内の、頻繁に使用されるツールおよびその他のリソースのリンクのリストを出力する。
これには情報ライブラリコンテンツの読み取りのアクセス許可が必要です
GET graph.facebook.com
/community/knowledge_quick_links?fields=title,link情報ライブラリの中の特定のクイックリンクを読む
これには情報ライブラリコンテンツの読み取りのアクセス許可が必要です
GET graph.facebook.com
/{quick_link_id}?fields=title,link情報ライブラリの中に新しいクイックリンクを追加する
これには情報ライブラリコンテンツの管理のアクセス許可が必要です
POST graph.facebook.com
/community/knowledge_quick_links?
title={...}&
link={...}情報ライブラリの中の特定のクイックリンクを更新する
これには情報ライブラリコンテンツの管理のアクセス許可が必要です
POST graph.facebook.com
/{quick_link_id}?
title={...}&
link={...}情報ライブラリの中の特定のクイックリンクを削除する
これには情報ライブラリコンテンツの管理のアクセス許可が必要です
DELETE graph.facebook.com
/{quick_link_id}