FacebookのGraph API（その5・Albumオブジェクト）

FacebookのGraph APIで得られるオブジェクトの2つ目として、Albumオブジェクトを解説します。

1.Albumオブジェクトの概要

Albumオブジェクトは、ユーザー／Facebookページ／アプリケーションの写真アルバムを表します。

例えば、以下のアドレスにアクセスすると、IDが10150146071791729のアルバムの情報を得ることができます。

https://graph.facebook.com/10150146071791729

なお、Albumオブジェクトの情報を読むには、以下のように、アクセストークンやPermissionが必要です。

• Publicなアルバムを読む場合は、アクセストークンが必要
• ユーザーのPublicでないアルバムを読む場合は、user_photosのPermissionが必要
• ユーザーの友達のPublicでないアルバムを読む場合は、friend_photosのPermissionが必要

2.Albumオブジェクトのフィールド

Albumオブジェクトには以下のようなフィールドがあります。

フィールド名	概要	戻り値
id	アルバムのID	文字列
from	アルバムを作成したユーザー等のプロフィール	idとnameのフィールドを含む オブジェクト
name	アルバム名	文字列
description	アルバムの説明	文字列
location	アルバムの場所	文字列
link	Facebook上でのアルバムのページのアドレス	ValidなURLを表す文字列
cover_photo	アルバムの表紙写真のID	文字列
privacy	アルバムのプライバシー設定	文字列
count	アルバム内の写真の数	文字列
type	アルバムのタイプ	文字列
created_time	アルバムの作成日時	ISO-8601日付形式の文字列
updated_time	アルバムの更新日時	ISO-8601日付形式の文字列

3.Albumオブジェクトのつながり

Albumオブジェクトには、以下のつながりがあります。

つながりの名前	概要	戻り値
photos	アルバムに含まれる写真	写真(photo)オブジェクトの配列
likes	アルバムに付けられたいいね	idとnameフィールドがあるオブジェクトの配列
comments	アルバムに付けられたコメント	id／from／message／created_timeフィールドがあるオブジェクトの配列
picture	アルバムの表紙写真	表紙写真へリダイレクト

例えば、以下のアドレスにアクセスすると、IDが10150146071791729のアルバムに含まれる写真の情報を得ることができます。

https://graph.facebook.com/10150146071791729/photos