album
Description
An album of photos or videos as represented in FQL.
Columns
| Name | Description | ||||||
|---|---|---|---|---|---|---|---|
aid | The album ID | ||||||
backdated_time timestamp | Time that the album is backdated to | ||||||
can_backdate bool | Can the album be backdated on Timeline | ||||||
can_upload bool | Determines whether a given UID can upload to the album. It is true if the following conditions are met: The user owns the album, the album is not a special album like the profile pic album, the album is not full. | ||||||
comment_info struct | The comment information of the album being queried. This is an object containing can_comment and comment_count | ||||||
| |||||||
cover_object_id numeric string | The album cover photo object_id | ||||||
cover_pid string | The album cover photo ID string | ||||||
created timestamp | The time the photo album was initially created expressed as UNIX time. | ||||||
description string | The description of the album | ||||||
edit_link string | The URL for editing the album | ||||||
is_user_facing bool | Determines whether or not the album should be shown to users. | ||||||
like_info struct | The like information of the album being queried. This is an object containing can_like, like_count, and user_likes | ||||||
| |||||||
link string | A link to this album on Facebook | ||||||
location string | The location of the album | ||||||
modified timestamp | The last time the photo album was updated expressed as UNIX time. | ||||||
modified_major timestamp | Indicates the time a major update (like addition of photos) was last made to the album expressed as UNIX time. | ||||||
name string | The title of the album | ||||||
object_id | The object_id of the album on Facebook. This is used to identify the equivalent Album object in the Graph API. You can also use the object_id to let users comment on an album with the Graph API Comments | ||||||
owner | The user ID of the owner of the album | ||||||
owner_cursor string | Cursor for the owner field | ||||||
photo_count unsigned int32 | The number of photos in the album | ||||||
place_id numeric string | Facebook ID of the place associated with the album, if any. | ||||||
type string | The type of photo album. Can be one of profile: The album containing profile pictures, mobile: The album containing mobile uploaded photos, wall: The album containing photos posted to a user's Wall, normal: For all other albums. | ||||||
video_count unsigned int32 | The number of videos in the album | ||||||
visible string | Visible only to the album owner. Indicates who can see the album. The value can be one of friends, friends-of-friends, networks, everyone, custom (if the visibility doesn't match any of the other values) | ||||||
size unsigned int32 | The number of photos in this album | ||||||
Examples
- SELECT ... FROM album WHERE object_id = A
- SELECT ... FROM album WHERE owner = A
- SELECT ... FROM album WHERE aid = A
Note: Additional filters on other columns can be specified but they may make the query less efficient.
Permissions
To read the album table you need
- any valid
access_tokenif it is public. user_photos[permissions][1] if it is not public and belongs to the user.friends_photos[permissions][1] if it is not public and belongs to a user's friend.