「Graph API Explorer」チュートリアル風

Facebookの開発者ページで、「Graph API」の動作確認ツールとして提供されている「Graph API Explorer」ですが、動作を理解するのに、ちょっと戸惑ったところがありましたので、「まだ、あまり触ったことが無い」という方をイメージしてチュートリアル風に書いてみました。

1 Graph APIとは

(1) Graph API

GraphAPIは、「Facebookのソーシャルグラフ」からデータを取得するためのAPIですが、最初に、この構造について簡単に整理しておきます。

GraphAPIは、下記のURLにGETリクエストをかけJSON形式でデータを取得するものです。
https://graph.facebook.com/{オブジェクト}/{コネクション}
上記リクエストには、パラメータとして「フィールド」や「パーミッション」などが追加できます。

(2) オブジェクト

オブジェクトとは、人や物の事で、ID（数字）もしくはusernameで指定します。
http://graph.facebook.com/OBJECT_ID
Facebookにおけるオブジェクトの種類は、https://developers.facebook.com/docs/reference/apiの一番下の「Objects」に列挙されています。

(3) コネクション

コネクションとは、オブジェクトとオブジェクトの繋がりで、こちらは名前で指定します。
http://graph.facebook.com/OBJECT_ID/CONNET_TYPE
それぞれのオブジェクトが持つコネクションの種類は、パラメータ「metadata=1」を付けてリクエストすると、connectionsフィールドに列挙されます。
https://developers.facebook.com/OBJECT_ID?metadata=1

(4) パラメータ

パラメータとして、フィールド指定、アクセストークンや、ロケーションなどが指定可能です。
?access_token=XXXXXX <=アクセストークンの指定
?locale=ja_JP <=ロケーションの指定
?fields=id,name,email　<=フィールド指定

2 Graph API エクスプローラの基本操作

(1) ログイン

Facebookにログインしていない状態で「Graph API Explorer」へアクセスすると図のような画面になります。

※Google Chromeでアクセスすると、右の結果表示の部分が下にずれて表示されてしまいます。下の方までスクロールして確認してみてください。

右上の「Log In」を押してFacebookにログインすると、リクエスト欄に「{id}?fields=id,name」がセットされ、自分の情報にアクセスした状態になります。また、取得された情報が右に表示されています。

※ここで表示されている{id}は、ログインアカウントのユーザオブジェクトのIDです。

(2) アクセストークンのクリア

指定するアクセストークンによって、取得結果に差が出ます。ここでは、アクセストークンが全く設定されていない状態にする事にします。既に、アクセストークンの所が空欄になっている場合は、以後の操作は必要ありません。

↑アクセストークンが空の状態

↑アクセストークンが設定されている状態

「Graph API Explorer」のアクセストークンは、ログインアカウントに紐着いて記憶されているため、過去に「Graph API Explorer」を操作したことがある方は、既にアクセストークンが設定されている場合があります。
この場合は、「≒アクセストークンを取得」を押して「Select Permission」ダイアログを表示し、「Clear」ボタンですべてのパーミッションを削除してください。すべてのチェックが消えた状態で「キャンセル」ボタンでダイアログを閉じるとアクセストークン欄は空になります。

※「≒アクセストークンを取得」を押しても「Select Permission」ダイアログがポップアップされない場合は、一度「▶送信」ボタンを押してみてください。