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

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

この記事を読むのに必要な時間:およそ 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からは参照できません。

著者プロフィール

松江祐輔(まつえゆうすけ)

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

URL:http://katamari.jp