詳細なユーザー情報の取得

続いて，ユーザーに関する別の情報も取得してみましょう。取得する情報によって次のScopeに分かれています。

以上の内容の許可を得る認可画面は，図4のようになります。

それでは，順に内容を見ていきましょう。

基本情報

wl.basicは，Windows LiveのプロフィールページのURLと，ユーザー情報が更新された日時，コンタクトリストの情報を参照する場合に使います。コンタクト（友だち）はContactオブジェクトとして別途取得します。その内容は次の機会に紹介します。

Userオブジェクトの内容は次の通りです。

生年月日

生年月日のみ参照するScopeが用意されています。当然ながらユーザーが設定してなければ参照できません。年まですべて設定されている場合，ここから年齢も計算できますね。

メールアドレス

メールアドレスは，いくつか種類があり，少なくともWindows Live IDのアカウントとなっているアドレスひとつは設定されています。レスポンスは次のようにemailsオブジェクト内に4種類のアドレスが格納されています。

{
    "emails": {
        "account": "***@live.jp", 
        "business": null, 
        "personal": null, 
        "preferred": "***@live.jp"
    }
}

それぞれの値は次の通りです。

住所

住所は，個人の住所と勤務先の住所があります。レスポンスは次のようになり，addressesオブジェクトに格納されています。さらに個人と勤務先によってpersonalオブジェクトとbusinessオブジェクトに分かれています。

{
    "addresses": {
        "personal": {
            "street": "外神田",
            "street_2": "大檜山ビル",
            "city": "千代田区",
            "state": "東京都",
            "postal_code": "101-0021",
            "region": "日本"
        },
        "business": {
            "street": "外神田",
            "street_2": "大檜山ビル",
            "city": "千代田区",
            "state": "東京都",
            "postal_code": "101-0021",
            "region": "日本"
        }
    }
}

personalとbusinessオブジェクトの値は次の通りです。

ユーザーは住所の情報に自由な値を入力できるため，使用する際はチェックが必要です。

電話番号

電話番号は，個人・携帯・勤務先の3種類あります。レスポンスは次のようになり，phoneオブジェクトに格納されています。

{
    "phones": {
        "personal": "05-71024-***",
        "business": "104-8596-***",
        "mobile": null
    }
}

値は次の通りです。

電話番号についても，ユーザーは自由な値を入力できるため，使用する際は書式のチェックが必要です。

勤務先

勤務先の情報は，会社名と役職のみ参照できます。構造は以下のようになっています。

{
   "work": [
        {
            "employer": {
                "name": "未来ガジェット研究所"
            },
            "position": {
                "name": "ラボメン No.001"
            }
        }
    ]
}

値は次の通りです。

Userオブジェクトに関する内容は以上です。オブジェクトの内容は，すべてではありませんが先に示した登録画面で使用しています。Userオブジェクトに関するScopeは細かく分類されていますので，アプリで必要な許可のみ，必要なときに要求するようにしましょう。

おわりに

今回はここまでです。いかがでしたでしょうか。今回は，最新の情報Live ConnectとJavaScript APIを利用したユーザー情報へのアクセスを紹介しました。次回以降も，さらなるLive Connectを活用したアプリ開発について紹介していく予定です。Technical Preview版のLive Connect情報も順次紹介していきますのでお楽しみに。