FacebookのGraph API（その4・Userオブジェクト後半）

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

しばらく間が開きましたが、FacebookのGraph APIの解説の続きです。
今日は、Userオブジェクトの後半として、つながりの情報を得ることについて解説します。

1.つながりの情報を得る

「https://graph.facebook.com/ユーザーのID/オブジェクトの種類」のようなアドレスにアクセスすることで、そのユーザーに関連するオブジェクトの情報を得ることができます。

一般に、ユーザーとオブジェクトは1対多の関係で結びついています。
例えば、1人のユーザーは、通常は多数のメッセージをウォールに投稿していますので、ユーザーとメッセージの関係は1対多です。
そのため、「https://graph.facebook.com/ユーザーのID/オブジェクトの種類」のようなアドレスにアクセスすると、オブジェクトの配列の形で情報が返されます。

以下の画面は、Graph API Explorerで、「https://graph.facebook.com/1268097446/posts」にアクセスした時の結果です。
「1268097446」は当方のFacebookでのIDです。
また、「posts」は、ウォールに投稿したメッセージを表します。

ウォールのメッセージを得たところ

2.つながりの種類

ユーザーとつながりがある情報は非常に多いです。
以下のような情報を得ることができます。
なお、以下の情報は、FacebookのGraph APIのドキュメントをほぼそのまま訳したものです。

種類概要必要なPermission戻り値
accountsユーザーが管理している
アプリケーションと
Facebookページ		アクセストークンが必要
manage_pagesの
Permissonを得ていれば、
個々のアプリ／Facebookページを
操作するためのアクセストークンも得られる
2011年9月22日から、
manage_pagesの
Permissonが必須		アカウントの
id／category／name
フィールドがある
オブジェクトの配列
achievementsゲームで得たものuser_games_activity
または
friends_games_activity		GETプロトコルはまだ実装されていない
activitiesユーザーの好きな活動user_activities
または
friends_activities		活動の
id／name
category／create_time
フィールドがある
オブジェクトの配列
albumsユーザーのアルバムuser_photos
または
friends_photos		albumオブジェクトの配列
apprequestsアプリケーションからの
目立つリクエスト		アクセストークンが必要リクエストの配列
booksプロフィールに
リストされている本		user_likes
または
friends_likes		本の
id／name
category／create_time
フィールドがある
オブジェクトの配列
checkinsチェックインした
場所		user_checkins
または
friends_checkins		checkinオブジェクトの
配列
events参加する
イベント		user_events
または
friends_events		eventオブジェクトの
id／name／start_time
end_time／location
rsvp_statusフィールドを含む
オブジェクトの配列
family家族関係user_relationshipsid／name
end_time／location
relationshipフィールドを含む
オブジェクトの配列
feedウォールread_stream最近の25件の
投稿のオブジェクトの配列
friendlists友達リストread_friendlists友達リストの
id／nameフィールドを含む
オブジェクトの配列
friends友達アクセストークンが必要友達の
id／nameフィールドを含む
オブジェクトの配列
games好きなゲームuser_likesid／name
category／created_time
フィールドを含む
オブジェクトの配列
groups参加している
グループ		user_groups
または
friends_groups		グループのversion／id／name
administrator
bookmark_orderフィールドを含む
オブジェクトの配列
homeニュースフィードread_stream最近の25件の
投稿のオブジェクトの配列
inbox受信箱read_mailboxthreadオブジェクトの配列
interests趣味・関心user_interests
または
friends_interests		趣味・関心の
id／name
category／create_time
フィールドを含む
オブジェクトの配列
likes「いいね」を付けた
Facebookページ		user_likes
または
friends_likes		id／name
category／create_time
フィールドがある
オブジェクトの配列
links投稿したリンクread_streamlinkオブジェクトの配列
moviesプロフィールに
リストした映画		user_likes
または
friends_likes		id／name
category／create_time
フィールドがある
オブジェクトの配列
musicプロフィールに
リストした音楽		user_likes
または
friends_likes		id／name
category／create_time
フィールドがある
オブジェクトの配列
notes投稿したノートread_streamnoteオブジェクトの配列
notifications通知manage_notificationsid／from／to
create_time／update_time
title／link
applications／unread
フィールドがある
オブジェクトの配列
outbox送信箱read_mailboxメッセージの配列
paymentsアプリケーションでの
支払		アプリケーションの
アクセストークン		id／from／to／amount
status／application
created_time／and updated_time
フィールドを含む
オブジェクトの配列
permissionsユーザーがアプリケーションに
許可したPermission		なしPermission名がキーで
値が1か0の
オブジェクトを含む
単一要素の配列
photosユーザー（または友達）に
タグ付けされた写真		user_photo_video_tags
または
friends_photo_video_tags		to／from
created_time／type
フィールドを含む
オブジェクトの配列
pictureプロフィール画像アクセストークン不要ユーザー画像のアドレスに
リダイレクトされる
(?type=square | small
normal | largeの
パラメータで
画像のサイズを指定できる)
postsウォールに自分が
投稿したメッセージ		アクセストークンが必要
publicでないメッセージを
得るためには
read_streamが必要		投稿のオブジェクトの配列
scoresスコアuser_games_activity
または
friends_games_activity		user／application
score／typeの
フィールドを含む配列
statusesユーザー自身が投稿した
ステータス		read_streamステータスメッセージ
オブジェクトの配列
taggedユーザーにタグ付された
メッセージ		read_streamid／from／to
picture／link／name
caption／description
properties／icon
actions／type
application／created_time
updated_timeの
各フィールドを含む
オブジェクトの配列
television好きなテレビ番組user_likes
または
friends_likes		id／name
category／create_timeの
フィールドを含む
オブジェクトの配列
updates受信箱のメッセージの
アップデート		read_mailboxメッセージの配列
videosユーザーに
タグ付けされた動画		user_videos
または
friends_videos		ビデオオブジェクトの
配列