使ってみよう！ Windows Live SDK/API

第50回　SkyDrive API 概要（3）──メディアファイルのアクセス

Windows Live, Live Connect, OAuth 2.0

この記事を読むのに必要な時間：およそ 7 分

写真情報の取得

次は，写真ファイルについてみてみましょう。写真ファイルはサムネイルなど多くの情報を持っています。多く情報を得られることを除いては，基本的な内容は通常のファイル（Fileオブジェクト）と同じです。ひとつの写真の情報は次のようなJSON形式で取得できます。

{
   "data": [
      {
         "id": "file.xxxxx", 
         "from": {
            "name": "梓 中野", 
            "id": "xxxxx"
         }, 
         "name": "azusa.jpg", 
         "description": null, 
         "parent_id": "folder.XXXXX", 
         "size": 486730, 
         "comments_count": 0, 
         "comments_enabled": false, 
         "tags_count": 0, 
         "tags_enabled": true, 
         "picture": "http://storage.live.com/...", 
         "source": "http://storage.live.com/...", 
         "images": [
            {
               "height": 380, 
               "width": 800, 
               "source": "http://storage.live.com/...", 
               "type": "normal"
            }, {
               "height": 83, 
               "width": 176, 
               "source": "http://storage.live.com/...", 
               "type": "album"
            }, {
               "height": 45, 
               "width": 96, 
               "source": "http://storage.live.com/...", 
               "type": "thumbnail"
            }, {
               "height": 975, 
               "width": 2048, 
               "source": "http://storage.live.com/...", 
               "type": "full"
            }
         ], 
         "link": "https://skydrive.live.com/redir.aspx?cid...", 
         "when_taken": null, 
         "height": 975, 
         "width": 2048, 
         "type": "photo", 
         "created_time": "2012-02-09T15:00:00+0000", 
         "updated_time": "2012-02-09T17:00:00+0000"
      }
   ]
}

写真を表すPhotoオブジェクトの内容は次の通りです。Fileオブジェクトにはない項目は太字にしています。images配列からサムネイル画像を取得できます。また，SkyDriveでは，写真に人物タグを付けられます。このタグ情報の有無も取得できます。

プロパティ 型 説明
data array Photoオブジェクトを含む配列（複数のアイテムを含む結果の場合）
id string PhotoオブジェクトのID
from object 作成者の情報
name（fromオブジェクト) string 作成者の名前
id（fromオブジェクト） string 作成者のユーザーID
name string 写真のファイル名（編集可能）
description string 説明（編集可能）
parent_id string この写真の上位階層のリソースID（親フォルダーのID）
size number 写真のサイズ（バイト単位）
comments_count number 写真に付けられたコメント数
comments_enabled true/false 写真にコメント可能かどうか
tags_count number 写真に付けられたタグ数
tags_enabled true/false 写真にタグ埋め込み可能かどうか
picture 写真のURL
source string 写真のダウンロード用のURL（一時的なURLで使う場合は取得後すぐに参照します）
images array 異なる大きさの写真の情報
height（images配列) number 高さ（ピクセル）
width（images配列) number 幅（ピクセル）
source（images配列) string 特定の大きさの写真のURL
type（images配列) string 大きさの種類
次の値のいずれか
  • full（最大2048x2048）
  • normal（最大800x800）
  • album（最大200x200）
  • small（最大100x100）
link string SkyDrive上での写真のURL
upload_location string アプリから写真をアップロードするためのURL
Scope「wl.skydrive」が必要
when_taken string/null 撮影日時（ISO 8601形式）
height number 高さ（ピクセル）
width number 幅（ピクセル）
type string オブジェクトの種類
写真の場合は，photo
created_time string 写真の作成日時（ISO 8601形式）
updated_time string 写真の最終更新日時（ISO 8601形式）
shared_with object 写真の共有情報
access（shared_withオブジェクト） string 写真の共有情報
次の値のいずれか
  • People I selected
  • Just me
  • Everyone (public)
  • Friends
  • My friends and their friends
  • People with a link

Fileオブジェクトにあった，埋め込み用のHTMLコードの取得可否を示すis_embeddableはPhotoオブジェクトにはありません。APIでは，埋め込み用のHTMLコードを生成できませんが，SkyDriveのWebサイトでは生成できます（図3⁠）⁠。

図3　写真の埋め込み

図3　写真の埋め込み

また，Webサイトでは，撮影したカメラ情報なども参照できますが，APIからは参照できません。

Windows Live, Live Connect, OAuth 2.0

著者プロフィール

松江祐輔（まつえゆうすけ）

日本システムウエア株式会社 勤務。現在，ハードウェア設計・検証業務を担当。大学生・大学院生時代はベンチャー企業 有限会社ミレニアムシステムズにプログラマーとして従事。趣味はプログラミング。好きな言語はVisual Basic。Microsoft MVP for Windows Live Platform（Jul 2010 - Jun 2011），Windows Live（Jul 2011 - Jun 2013）。

URL：http://katamari.jp