サポートしているファイル

扱うファイルにも制限があります。サポートしているファイルは，次の通りです。

• ドキュメント（PDF，テキストファイル，マイクロソフトOffice文書）
• 写真（一般的なファイルフォーマットのみ）
• ビデオ（H.264およびWindows Media Video）
• 音楽（アップロードはWaveファイルのみ）

大きく分類して，ドキュメント・写真・ビデオ・音楽の4種類があります。サポートしていない形式（拡張子）は，アップロードできません。ただし，参照やダウンロードは可能です。

APIを利用したアプリの開発

Live Connectは，ユーザーの認証に，標準的なプロトコルのOAuth 2.0を利用しています。OAuthの仕組みに従って，アプリは利用者からリソースのアクセス許可を得て，SkyDriveなどのリソースを操作します。Live ConnectとOAuthについては，第45回で詳しく説明していますので，そちらをご覧ください。また，事前にアプリケーション設定サイトで，アプリの登録が必要です。新しくガイドラインが提供されています。こちらも開発する前に併せて確認してください。

Live Connectでは，リソースのアクセスにREST APIを利用します。一部のリソースを除いて，すべてHTTP(S)の通信と，JSON形式のデータのやりとりで行います。基本的にどのアプリもこのREST APIを利用してリソースアクセスを行います。

Webブラウザー上で動作するアプリとWindows 8およびWindows Phone向けには，JavaScript APIとManaged APIも利用できます。ライブラリーとして提供されていて，内部ではOAuthによる認可処理とREST APIの呼び出しが行われていますが，より簡単にそして各プラットフォームに適したUIが提供されています。JavaScript APIは，これまでにも紹介していますので，以前の連載内容を参照してください。

今回の簡単なサンプルコードでは，REST APIのみを使用します。それでは，SkyDriveに関係するREST APIをみていきましょう。

フォルダー情報の取得

最初にフォルダーの情報を取得してみましょう。たとえば，SkyDriveのルートフォルダーの情報は次のURLにアクセスすると得られます。

• https://apis.live.net/v5.0/me/skydrive?access_token=ACCESS_TOKEN

URLのACCESS_TOKENには，OAuthのAccess token（アクセストークン）を指定します。手っ取り早くアクセストークンを得るには，Webブラウザーに次のURLを入力します。認可画面（図4）に移動し，認可後のURLを参照するとアクセストークンが含まれています。

• https://oauth.live.com/authorize?client_id=CLIENT_ID&scope=wl.skydrive&response_type=token&locale=ja&redirect_uri=https://oauth.live.com/desktop

CLIENT_IDには，アプリ登録時に取得したClient IDを指定します。

アクセストークンの取得については，第45回で詳しく説明していますので，そちらも参照してください。

SkyDriveのアクセスについて，ユーザーから認可を得るときに指定する許可の内容Scope（スコープ）は，次の通りです。

ファイルの読み取りだけが必要な場合は，wl.skydriveを指定し，作成などのアクセスも含める場合は，wl.skydrive_updateを指定します。アプリに必要な許可のみユーザーに要求するようにしましょう。上記以外にも，よりアルバムや写真のアクセスに操作を制限した，wl.photosや，wl.contacts_photosも指定できます。

最初のURLにアクセスすると，ルートフォルダーの情報が，次のようなJSON形式で取得できます。

{
   "id": "folder.xxxxx", 
   "from": {
      "name": null, 
      "id": null
   }, 
   "name": "SkyDrive", 
   "description": null, 
   "parent_id": null, 
   "upload_location": "https://apis.live.net/v5.0/folder.xxxxx/files/", 
   "count": 4, 
   "link": "https://skydrive.live.com?cid\xxxxx", 
   "type": "folder", 
   "shared_with": {
      "access": "Just me"
   }, 
   "created_time": null, 
   "updated_time": "2012-01-09T14:00:00+0000"
}

Webブラウザーでも，簡単に内容を確認できます（図5⁠）⁠。

このフォルダーの情報を表すFolderオブジェクトの内容は，次の通りです。

ひとつのフォルダー情報を取得する場合は，パスにFolderオブジェクトIDを指定してHTTP GETメソッドでアクセスします（URLのFOLDER_IDには，FolderオブジェクトのIDを指定します⁠）⁠。

• https://apis.live.net/v5.0/FOLDER_ID?access_token=ACCESS_TOKEN

フォルダー内のアイテムを取得する場合は，パスに/filesを付けて次のようにします。

• https://apis.live.net/v5.0/FOLDER_ID/files?access_token=ACCESS_TOKEN

フォルダー情報を返すリソースのパスは，次の通りです。

上記のUSER_IDは，パス「/me」などで得られるユーザーのIDです。ALBUM_IDは，今回紹介しませんが，アルバムを表すAlbumオブジェクトのIDです。

フォルダーに格納できるアイテムは，フォルダー，ファイル，写真，ビデオ，音楽の5種類です。実際に，写真などが含まれているフォルダーのファイル一覧を取得してみるといろいろな情報が得られると思います。