FacebookのGraph API(その8・Groupオブジェクト)

  • 投稿日:
  • by
  • カテゴリ:

FacebookのGraph APIのその8として、Groupオブジェクトを紹介します。

1.Groupオブジェクトの概要

Groupオブジェクトは、グループを表すオブジェクトです。

公開されているグループの情報を得る場合は、アクセストークンが必要です。
ユーザーが属している非公開のグループの情報を得るには、そのユーザーのuser_groupsのPermissionが必要です。
また、ユーザーの友達が属している非公開のグループの情報を得るには、そのユーザーのfriends_groupsのPermissionが必要です。

例えば、https://graph.facebook.com/195466193802264にアクセスすると、以下のようにFacebook Developersのグループの情報を得ることができます。

{
  "id": "195466193802264", 
  "version": 1, 
  "owner": {
    "name": "Ravi Grover", 
    "id": "202875"
  }, 
  "name": "Facebook Developers", 
  "description": "Description.", 
  "privacy": "OPEN", 
  "icon": "http://static.ak.fbcdn.net/rsrc.php/v1/yI/r/0pjqWL1NfkE.png", 
  "updated_time": "2011-03-12T02:43:05+0000", 
  "email": "195466193802264@groups.facebook.com", 
  "type": "group"
}

2.Groupオブジェクトのフィールド

Groupオブジェクトには以下のようなフィールドがあります。

フィールド名概要戻り値
idGroupのID文字列
versionGroupのバージョン2010年10月以前の古いグループなら0
そうでなければ1
iconGroupのアイコンのアドレスURLを表す文字列
ownerGroupを作ったユーザーid/nameフィールドがあるオブジェクト
nameGroupの名前文字列
descriptionGroupの概要文字列
linkGroupのウェブサイトのアドレスURLを表す文字列
privacyGroupの公開設定OPEN/CLOSED/SECRETのいずれか
updated_timeGroupの更新日時ISO-8601日付形式の文字列

3.Groupオブジェクトのつながり

Groupオブジェクトから、以下のようなつながりの情報を得ることができます。
例えば、https://graph.facebook.com/195466193802264/feedにアクセスすると、Facebook Developers Groupのウォールに投稿されたメッセージの情報を得ることができます。

名前概要戻り値
feedウォールのメッセージPostオブジェクトの配列
membersグループのメンバーid/nameフィールドがあるオブジェクトの配列
管理者ユーザーではadministratorフィールドも追加される
pictureGruopのプロフィール画像画像のアドレスへリダイレクト
docsGruopのドキュメントid/from/subject/message/icon/updated_time/revision/can_edit/can_deleteフィールドがあるオブジェクトの配列

MT Cloud Starter Kit
Movable Typeのプラグイン集「MT Cloud Starter Kit」をぜひご利用ください