sakazuki.info

たまに近況が更新されたりします

Facebookのソーシャルグラフが取得できる「Graph API」文書の日本語訳(前半)

calendar

reload

Facebook関連のお仕事をしている方向け記事。

フェイスブックのソーシャルグラフを取得することができる
Graph APIの文書を、日本語に訳してみました。

英語版:
http://developers.facebook.com/docs/reference/api/

意訳している部分もあり、
正確性の保証はありませんがご参考までにどうぞ!

————————————————————————————————-
Facebookの「キモ」はソーシャルグラフにあります。

(ソーシャルグラフというのは、
人々と、彼らが関心を持つ物とのコネクションの事を指します。)

グラフAPIというのはFacebookのソーシャルグラフを提供するものであり、
人、写真、イベントやページと、それらのつながりを見せてくれます。

ソーシャルグラフ上の全てのオブジェクトは、
ユニークIDを持っています。

「https://graph.facebook.com/ID」をリクエストすることにより、
そのオブジェクトの持つ情報にアクセスする事が可能です。

例えば、Facebook Platformのオフィシャルページ
(http://www.facebook.com/platform)
のIDは、「19292868552」です。

https://graph.facebook.com/19292868552 にアクセスすると
オブジェクトを読み込むことができます。

↓取得した情報

{
“name”: “Facebook Platform”,
“type”: “page”,
“website”: “http://developers.facebook.com”,
“username”: “platform”,
“founded”: “May 2007”,
“company_overview”: “Facebook Platform enables anyone to build…”,
“mission”: “To make the web more open and social.”,
“products”: “Facebook Application Programming Interface (API)…”,
“likes”: 449921,
“id”: 19292868552,
“category”: “Technology”
}

また、ユーザーネームを持つ人やページに関しては
IDではなくUSERNAMEを利用してアクセスすることも可能です。

さきほどのページでは、「platform」がユーザーネームですので
https://graph.facebook.com/platform
でもアクセスする事が可能です。

全てのレスポンスは、JSONオブジェクトとして
返ってきます。

同様の方法でアクセスできるFacebook上のオブジェクトは下記の通りです。

Users: https://graph.facebook.com/btaylor (Bret Taylor)
Pages: https://graph.facebook.com/cocacola (Coca-Cola page)
Events: https://graph.facebook.com/251906384206 (Facebook Developer Garage Austin)
Groups: https://graph.facebook.com/195466193802264 (Facebook Developers group)
Applications: https://graph.facebook.com/2439131959 (the Graffiti app)
Status messages: https://graph.facebook.com/367501354973 (A status message from Bret)
Photos: https://graph.facebook.com/98423808305 (A photo from the Coca-Cola page)
Photo albums: https://graph.facebook.com/99394368305 (Coca-Cola’s wall photos)
Profile pictures: http://graph.facebook.com/sakaikazuki/picture (your profile picture)
Videos: https://graph.facebook.com/817129783203 (A Facebook tech talk on Graph API)
Notes: https://graph.facebook.com/122788341354 (Note announcing Facebook for iPhone 3.0)
Checkins: https://graph.facebook.com/414866888308 (Check-in at a pizzeria)

フェイスブックのソーシャルグラフ上の全てのオブジェクトは、
お互いの関係性(relationship)によってつなげられています。

Bret Taylor(先ほど出てきたUSER)は、コカコーラの
Facebookページのfanになっており、
Bret Taylor と Arjun Bankerは友達です。

フェイスブックのAPIでは、これらのつながりを
「connections」と呼んでいます。

オブジェクト同士のconnectionsは、
下記のURLを利用することで調べることができます。

https://graph.facebook.com/ID/CONNECTION_TYPE

調べることができるconnectionsとしては、
次のようなものがサポートされています。

Friends: https://graph.facebook.com/me/friends?access_token=…
News feed: https://graph.facebook.com/me/home?access_token=…
Profile feed (Wall): https://graph.facebook.com/me/feed?access_token=…
Likes: https://graph.facebook.com/me/likes?access_token=…
Movies: https://graph.facebook.com/me/movies?access_token=…
Music: https://graph.facebook.com/me/music?access_token=…
Books: https://graph.facebook.com/me/books?access_token=…
Notes: https://graph.facebook.com/me/notes?access_token=…
Permissions: https://graph.facebook.com/me/permissions?access_token=…
Photo Tags: https://graph.facebook.com/me/photos?access_token=…
Photo Albums: https://graph.facebook.com/me/albums?access_token=…
Video Tags: https://graph.facebook.com/me/videos?access_token=…
Video Uploads: https://graph.facebook.com/me/videos/uploaded?access_token=…
Events: https://graph.facebook.com/me/events?access_token=…
Groups: https://graph.facebook.com/me/groups?access_token=…
Checkins: https://graph.facebook.com/me/checkins?access_token=…

異なるオブジェクトの間において、
様々なconnectionsを調べることが可能です。

例えば下記のURLでは、
「Facebook Developer Garage at SXSW」(ID #331218348435)
に出席しているユーザーのリストを取得することができます。

https://graph.facebook.com/331218348435/attending?access_token=….

サポートされているオブジェクトとConnectionsは、
下記にまとまっています。

http://developers.facebook.com/docs/reference/api/

ここまでで1/3程度。
続きはまた更新します。