More than 5 years have passed since last update.

TECH PLAY女子部Advent Calendar 2017

Facebook Graph APIを使用してユーザー情報を取得する

Last updated at 2017-12-04Posted at 2017-12-04

最近、FacebookログインとFacebook Graph APIを使用した機能を実装しました。
本記事では、Facebook Graph APIを用いてユーザー情報を取得する方法と注意点について紹介します。
これからFacebook Graph APIを使用する方の参考になれば幸いです。

注意

この情報は2017年11月2日現在のものです。
Graph APIのバージョンはv2.10です。

Graph APIとは

Graph APIの公式サイトには、Graph APIについて下記のように説明されています。
Graph API

グラフAPIは、Facebookのソーシャルグラフにデータを取り込んだり、データを取り出したりするための主な方法です。データのクエリ、新しい記事の投稿、写真のアップロード、アプリで行う必要があるその他のさまざまなタスクに利用できるローレベルのHTTPベースのAPIです。

Graph APIを用いることで、ユーザーの情報を取得・投稿することができます。

通信の流れ

Graph APIとの通信の流れはざっくりと以下のようになります。

ユーザーがFacebookにログイン、ユーザーデータへのアクセス許可を行う
FacebookがAccess Tokenを発行する
Access Tokenをサーバーサイドに渡す
Access Tokenの不正チェックを行う
ユーザーの情報を取得する

今回はサーバサイド側に注目し、4,5について説明します。

Access Tokenの不正チェックを行う

1〜3の過程でFacebookから発行されたAccess Tokenを用いて、Facebookとの接続を行います。

その際、トークンハイジャックを防ぐためにクライアントから送られたAccess Tokenが、自分のFacebookアプリケーションに対して発行されたAccess Tokenかどうかをチェックする必要があります。

Access Tokenが不正なものではないかどうかをチェックする際には、/debug_tokenエンドポイントを使用します。

エンドポイント

/debug_token?input_token={ユーザーのAccess Token}&access_token={app_id}|{app_secret}

/debug_tokenエンドポイントのリクエストパラメーターにはinput_tokenとaccess_tokenが必要です。
ユーザーのAccess Tokenが正しいことをチェックする際には、ユーザーのAccess Tokenは、acccess_tokenではなくinput_tokenを記述するという点に注意してください。

access_tokenには、Facebookアプリケーションの情報を記述します。
具体的には、｛Facebookアプリケーションのapp_id}|{Facebookアプリケーションのapp_secret}を記述します。

例えば、
ユーザーのAccess Tokenがuser、Facebookのapp_idが123、app_secretがsecretとした場合、下記のようなリクエストになります。

/debug_token?input_token=user&access_token=123|secret

レスポンス

正しいinput_token, access_tokenを入力した場合は、下記のようなレスポンスが返ります。

{
  "data": {
    "app_id": app_id,
    "type": "APP",
    "application": アプリケーション名,
    "is_valid": true,
    "scopes": [
    ]
  }
}

不正なAccess Tokenを入力した場合は下記のようなレスポンスが返ります。

{
  "error": {
    "message": "Invalid OAuth access token.",
    "type": "OAuthException",
    "code": 190,
    "fbtrace_id": ""
  }
}

また、違うアプリケーションのAccess Tokenを入力した場合は下記のようなレスポンスが返ります。

{
  "error": {
    "message": "(#100) The App_id in the input_token did not match the Viewing App",
    "type": "OAuthException",
    "code": 100,
    "fbtrace_id": ""
  }
}

エラーの種類が複数あることに注意してください。
エラーが発生していない場合、Access Tokenが有効なものであると判断できます。

参考：アクセストークン：デバッグとエラー処理

Access Tokenの確認後、ユーザーの情報を取得します。

ユーザー情報の取得

ユーザーの基本情報（名前・年齢など）

ユーザーの基本情報を取得したい場合、/{user_id}というエンドポイントを使用します。
また、自分の情報に限り/meというエンドポイントで情報を取得できます。
今回は/meを使用します。

/meエンドポイントのパラメーターに、取得したいフィールドを記述します。
例えば、ユーザーのID、名前、プロフィール画像を取得したい場合は/me?fields=id,name,pictureと記述します。
実際に/me?fields=id,name,pictureエンドポイントを叩いた際は、下記のレスポンスが返ってきます。

エンドポイント

/me?fields=id,name,picture

レスポンス

{
  "id": ユーザーID,
  "name": 名前,
  "picture": {
    "data": {
      "is_silhouette": 初期ユーザー画像かどうか(プロフィール画像を設定してない場合trueになる),
      "url": 画像のURL
    }
  }
}

filedsに指定できるフィールドは他にも多くあります。

参考：Graph API Reference User

友人・友人数を取得したい場合

ユーザーの友人数や、同じアプリを使用している友人を取得したい場合は、/meのfilelsにfriendsを指定します。
このエンドポイントを叩く際にはこのエンドポイントで取得できる友人は、ユーザーのすべての友人ではなく同じFacebookアプリケーションを使用している友人のみが取得できるという点に注意してください。

エンドポイント

/me?fields=friends

レスポンス

{
  "data": [
    {
      "name": 友人の名前,
      "id": ユーザーID
    },
    ...
  ],
  "summary": {
    "total_count": ユーザーの友人数
  }
}

summaryの中のtotal_countがユーザーの総友人数です。
また友人一覧は、dataに配列として返ってきます。
data内の配列には、友人それぞれの名前とユーザーIDが記載されています。

プロフィール画像のサイズを指定したい場合

プロフィール画像を取得したい場合はfieldsにpictureを指定して/me?fields=pictureとなります。
プロフィール画像など、取得する画像のサイズを変更したい場合は、width,hightというパラメータをつけることによって画像のサイズを指定することができます。

エンドポイント

/me?fields=picture.width(720).hight(720)

レスポンス

{
  "picture": {
    "data": {
      "height": 720,
      "is_silhouette": false,
      "url": 指定したサイズの画像のURL,
      "width": 720
    }
  },
  "id": ユーザーID
}

アクセス許可の確認したい場合

初回認証時にユーザー情報への読み取りが許可されている場合でも、ユーザー自身がアプリ設定画面から自由に、アプリのアクセス許可を変更することができます。
ユーザーが下記のようにチェックを外し、アクセス許可を変更することで、今まで取得できていたデータが取得できなくなります。

そのため、ユーザー情報の取得する前にAccess Tokenのアクセス許可を確認する必要があります。
アクセス許可を確認する場合は/meエンドポイントのfieldsにpermissionsを指定します。

エンドポイント

/me?fields=permissions

レスポンス

{
  "permissions": {
    "data": [
      {
        "permission": "public_profile",
        "status": "granted"
      },
      {
        "permission": "publish_actions",
        "status": "declined"
      },
      {
        "permission": "email",
        "status": "declined"
      },
    ]
  },
  "id": ユーザーID
}