小粋空間  -  a cheap joke and a play on words site

Facebook開発者向けツール「Graph API Explorer」徹底解説

先日、Facebookから開発者向けツールGraph API Explorerがローンチされました。

Graph API Explorer

本エントリーではGraph API Explorerの使い方を、ウォールにメッセージを投稿する方法を中心に解説します。

１．Graph APIとは

Graph APIはFacebook上のデータにアクセスするためのAPIです。実際にはプログラム上でGraph APIを起動するのですが、Graph API Explorerを使えばプログラムを作成する前にGraph APIの動作確認を行うことができます。

Graph APIの詳細は以下の公式サイトを参照してください。

Graph API

２～５項でウォールにメッセージを投稿する手順を説明しますので、Graph API Explorerにアクセスした状態にしてください。

２．アクセストークンの取得とパーミッションの設定

ウォールの投稿にはアクセストークンが必要なので、右側にある「Get Access Token」をクリック。

パーミッションの選択ダイアログが表示されます。

「Extended Permissions」をクリックして、ウォールの投稿に必要なパーミッション「publish_stream」をチェックし、「Get Access Token」をクリック。

アプリの許可ウィンドウが開くので、「許可する」をクリックします。なお、選択したパーミッションに対応する動作がウィンドウの左側（ここでは「ウォールへの投稿」）に表示されるので、動作に対応するパーミッションが不明な場合、ここで確認することもできます。

これでアクセストークンが取得できました。

３．URLとPOSTデータの設定

ウォールの投稿はPOSTメソッドを利用するので、「POST」を選択します。

URLの末尾を「me/feed」に変更し、ウォールの投稿であることを指定します。

「Add a field」をクリック。これはPOSTデータに相当します。

「key」に「message」、「value」に適当なメッセージを入力します。ここではmessageのみ指定していますが、「Add a field」をクリックしてさらにパラメータを増やすことも可能です。

４．APIの実行

右側にある「Submit」をクリック。

下のテキストエリアにレスポンスが表示されます。JSON形式で「id: "xxxxx..."」が表示されればウォールの投稿は成功です。

自分のウォールにアクセスすると投稿されてました。ちょっと感動です（笑）。

５．パーミッションのクリア

アクセストークン取得後、再度「Get Access Token」をクリックしてパーミッションを確認したところ、自動的に次のようにチェックされていました。

ウォール投稿の場合、投稿を削除するときに「Graph API Explorerも削除」をチェックして削除すれば、さきほどのパーミッションの設定などがクリアされるようです（多分）。

他の方法でパーミッションをクリアする方法はみつけられていません。「Get Access Token」の左側にある×印をクリックしてもテキストフィールドがクリアされるだけです。

６．Connections

右側にある「Connections」のリンクをクリックすれば、関連するオブジェクトのリストを取得できます。アクセストークンを取得した状態でのクリックを推奨します。

例えば「feed」をクリックすれば、投稿一覧のレスポンスデータ（JSONオブジェクト）を取得できます。

レスポンスデータの青色部分はリンクになっています。

クリックすれば、そのオブジェクトのデータのみを表示します。

元に戻るには「Back to Parent」をクリックします。

７．Fields

「Fields」にはレスポンスデータの説明が表示されるようですが、初期画面でしか表示されません（操作ミスだったらすいません）。

以上です。「Graph APIがよく分からない」という人も、Graph API Explorerで少しとっつきやすくなるのではないでしょうか（ならないか）。