アルバム情報の取得

アルバムはフォルダーと同じ情報を持っています。SkyDrive直下のアルバム一覧を取得する場合，次のURLにアクセスすると得られます。

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

URLにアクセスすると，次のようにJSON形式でアルバム情報を取得できます。

{
   "data": [
      {
         "id": "folder.xxxxx", 
         "from": {
            "name": "梓 中野", 
            "id": "xxxxx"
         }, 
         "name": "ビデオ", 
         "description": null, 
         "parent_id": "folder.XXXXX", 
         "count": 16, 
         "link": "https://skydrive.live.com/redir.aspx?cid...", 
         "type": "album", 
         "created_time": "2010-10-30T14:00:00+0000", 
         "updated_time": "2012-01-25T11:00:00+0000"
      }
   ]
}

アルバムの情報を表すAlbumオブジェクトの内容は，次の通りです。これは第48回で紹介したFolderオブジェクトとまったく同じです。ただし，写真・ビデオのアクセス許可しかない場合，一部の項目は取得できません。

フォルダーとアルバムでは，typeの値が「folder」と「album」で異なります。

アルバム情報を返すリソースのパスは次の通りです。あわせて第48回のフォルダー情報を返すリソースのパスも参照してください。

アルバムの作成

アルバムを作成する場合は，Scope「wl.skydrive_update」の許可が必要です。作成方法は，第49回で紹介したフォルダー作成と同じです。アルバムはSkyDrive直下にのみ作成可能で，「⁠/me/albums」へHTTP POSTメソッドでデータを送信します。HTTPの通信内容は次のようになります。

POST https://apis.live.net/v5.0/me/albums?access_token=ACCESS_TOKEN HTTP/1.1
Content-Type: application/json
Host: apis.live.net
Content-Length: 31
Connection: Keep-Alive

{name: "新しいアルバム"}