ブリリアントなWP7

Windows Liveの情報取得方法

WP7.1, Windows Live

Windows Live から情報を取得する方法について解説します。具体的な取得方法は別エントリーで行います。
なお、Windows Live認証を行うまでの方法は "Windows Liveの導入から認証までの方法" エントリーを参照ください。

情報取得方法

必要な情報を取得するためには、以下の2つが必要になります。

• 該当権限の付与
• 情報アクセスパスを使っての情報取得処理

情報に対する利用権限の付与

Windows Live情報を取得するには、情報グループに応じてユーザー許諾が必要になり、許諾範囲は利用権限によって決められています。
Windows Live認証時のユーザー許諾画面に、利用権限に応じた取得情報の内容がユーザーへ開示され、ユーザーが同意して初めて対象情報グループへのアクセスが行える仕組みになっています。
利用権限はSignInButtonコントロールのScopesプロパティに半角スペースをセパレータにして以下のように設定します。

<phone:PhoneApplicationPage
    …省略…
    xmlns:my="clr-namespace:Microsoft.Live.Controls;assembly=Microsoft.Live.Controls"
    >
    <my:SignInButton Content="Button" Height="71" Name="signInButton1" Width="204" Branding="Skydrive" ClientId="_ClientID_" RedirectUri="https://oauth.live.com/desktop" Scopes="wl.basic wl.signin wl.signin"
</phone:PhoneApplicationPage>

情報へのアクセス処理

ユーザーに利用許可して貰ったデータ群に対して、情報アクセスパスを使って取得する事になります。
sessionはSignInButtonで認証した時に取得したセッションを利用します。

    …省略…
    LiveConnectClient liveConnectClient = new LiveConnectClient(session);
    liveConnectClient.GetCompleted += new EventHandler<LiveOperationCompletedEventArgs>(liveConnectClient_GetCompleted);
    liveConnectClient.GetAsync("情報アクセスパス");
}

void liveConnectClient_GetCompleted(object sender, LiveOperationCompletedEventArgs e) {
    if (e.Error == null) {
        // ここで情報アクセスパス先のデータである e.Result を解析します
    }
}

利用権限と情報アクセスパスの重要性が分かって頂けたかと思います。
これ以降、利用権限と情報アクセスパスの詳細を解説していきます。

利用権限一覧

Windows Live情報の利用権限は、スコープ毎に用意されています。Core scopesは3つとも権限付与しておくのが無難で、Extended scopesは取得対象データを確認してから付与するか決めてください。
似たような権限が多くて分かりにくいですが、"Windows Live情報と利用権限の対照表" 見出しに書いてある表を見て権限付与するといいです。

Core scopes

Extended scopes

Developer scopes

Windows Live情報と利用権限の対照表

情報グループに対して必要な利用権限と、情報アクセスパスを以下の表にまとめました。

参考

REST API -MSDN
Scopes and permissions -MSDN


技術部　かわかみひろき

ツイートする

Permalink | コメント(1) | トラックバック(0) | 13:23