今回からはWindows Live スペースのフォト アルバムを操作できるWindows Live Photo APIについてです。

Windows Live スペース フォト アルバム

ブログサービスであるWindows Live スペースとその機能のひとつフォト アルバムをご存知でしょうか。フォト アルバムは，写真などの画像ファイルをアルバムとして分類し，Webサイト上にアップロードして公開できるサービスです（図1⁠）⁠。

図1　フォト アルバム

通常は，ユーザーはアルバムの作成や写真のアップロードをWebサイトまたはWindows Live フォト ギャラリーから行いますが，Windows Live SDKにはフォト アルバムをプログラムから操作できるAPIが提供されています。今回からは，そのAPIを使ってみましょう。

Windows Live Photo API

フォト アルバムを操作できるAPIはWindows Live Photo APIと呼ばれ，使用するプロトコルの違いにより

• Windows Live Photo WebDAV API
• Windows Live Photo ATOM API

の2種類があります。

API利用によって次の操作が可能です。

• 写真のアップロードおよびダウンロード
• アルバムの作成
• 写真またはアルバムの名前変更および削除

Live Photo APIは，Windows Live ID委任認証と併せて利用します。つまり，フォト アルバムを操作するためにあらかじめユーザーの承認を得る必要があります。委任認証については本連載の第14回と15回に紹介しています。

以上のことからAPI利用によりWindows Liveユーザーのブログスペースをフォトストレージとして使用したり，ブログスペースからフォトを参照・利用するなどのWebアプリケーションの作成が可能であることがわかります。

WebDAV API，ATOM APIともCTP（Community Technology Preview）リリースです。今後，仕様が変わる可能性がありますので利用には注意してください。

アクセス許可

ここからは委任認証を理解しているものとして進めます。委任認証ではアプリケーションプロバイダ（通常はWebサイト）が必要とするアクセス許可（オファーとアクション）を指定し，ユーザーの承認を得る必要があります。今回のPhoto APIではフォト アルバムに対しての操作のオファーおよびアクションを指定します。

Photo APIで使用するオファーとアクションの組み合わせは次の2種類です。

必要とするオファー・アクションを承認要求URL，psパラメータに指定しましょう。コンマ（,）区切りで両方を指定することも可能です。ユーザーがアクセスする承認要求ページは図2のようになります。

図2　承認要求ページ

図は2種類のオファーとアクションを指定した場合です。

フォト アルバムへのアクセス

本連載はAtom Publishing（AtomPub）プロトコルに基づいたWindows Live Photo ATOM APIの利用方法を紹介します。AtomPubプロトコルはHTTPによるXMLをベースとしたWeb APIによく使用される仕様です。以前のLive Photo API （⁠以前はWindows Live Spaces Photo APIと呼ばれていました）は，WebDAVプロトコルのみでしたがCTPリリースからAtomPubによる操作が可能になりました。

フォト アルバムを操作するには，次の書式に従ったURLへアクセスし，HTTPのGETやPOSTメソッドによりアルバム・写真情報の取得やアップロードを行います。

https://cumulus.services.live.com/@C@[LID]/AtomSpacesPhotos[/リソースへのパス]

[LID]にはユーザーデータの場所を示す識別子，委任認証により取得した承認トークンのlidパラメータを指定します。URLの末尾にはリソースへのパス，つまりアルバムや写真を示す値を指定します。

上記URLへアクセスするときに，HTTPのAuthorizationヘッダを指定する必要があります。ヘッダの値に承認トークンのdeltパラメータの値（委任トークン）を使います。

以上をまとめると，フォト アルバムへアクセスするHTTPのリクエストヘッダは次のようになります。

[HTTP Method] /AtomSpacesPhotos[/リソースへのパス] HTTP/1.1
Host: cumulus.services.live.com
User-Agent: [Name of User Agent]
Authorization: DelegatedToken dt="[委任トークン]"