Album

A media album as represented in the Family Graph API.

Media items in a family site can be organized in albums. An album contains a list of media items (photos, videos, documents and audios). A media item can be in one album, multiple albums or even in no albums at all.


Fields

The Album object contains the following fields:

Name Description Type Access Mode

id

The album's id

id

read

name

The album's name

string

read, write

description

The album's description

string

read, write

link

Link to album on MyHeritage.com

string

read

submitter

The user who submitted (created) the album in the family site

User object: id and name fields

read

created_time

The date and time when the album was submitted to the family site

string (YYYY-MM-DD HH:MM:SS)

read

updated_time

The date and time when the album was last updated (including adding or removing media item from the album)

string (YYYY-MM-DD HH:MM:SS)

read

media_count

Number of media items in the album

int

read

is_public

Indicates whether the album is public (its media items can be searched and viewed by other users)

boolean

read, write

is_default_family_album

Indicates whether this album is the default family album originated upon site creation

boolean

read

site

The site of the album

Site object: id and name fields

read

cover_photo.url,thumbnails

The albums cover photo

Photo object: id and name fields

read

class_name

The object class name

string

read

Connections

The Album object contains the following connections:
Name Description Type Access Mode

keywords

List of keywords associated with the media item

array of strings

read

media

List of media items in the album

array of MediaItem objects

read, write

Example

https://familygraph.myheritage.com/album-144530322-1900003 (open in browser)
{
"id": "album-144530322-1900003",
"name": "classic photos",
"link": "https:\/\/www.myheritage.com\/album-1900003_0_144530322_144530322\/classic-photos",
"submitter": {
"id": "user-10",
"name": "Developer MyHeritage"
},
"created_time": "2010-03-16T14:49:33+0000",
"updated_time": "2010-03-16T14:49:33+0000",
"media_count": 44,
"is_public": true,
"site": {
"id": "site-144530322",
"name": "Demo Family Site"
},
"cover_photo": {
"url": "https:\/\/www.myheritageimages.com\/D\/storage\/site144530322\/files\/00\/00\/60\/000060_60119024dbj2h4y1d3f6b5.jpg",
"thumbnails": [
{
"url": "https:\/\/www.myheritageimages.com\/D\/storage\/site144530322\/files\/00\/00\/60\/000060_60119024dbj2h4y1d3f6b5.jpg",
"width": 400,
"height": 600,
"class_name": "Image"
},
{
"url": "https:\/\/thumbnail.myheritageimages.com\/530\/322\/144530322\/000\/000060_60119024dbj2h4y1d3f6b5_D_171x256.jpg",
"width": 171,
"height": 256,
"class_name": "Image"
},
{
"url": "https:\/\/thumbnail.myheritageimages.com\/530\/322\/144530322\/000\/000060_60119024dbj2h4y1d3f6b5_D_27x40.jpg",
"width": 27,
"height": 40,
"class_name": "Image"
}
],
"id": "photo-144530322-1-1000060",
"name": "JFK with daughter Caroline"
},
"class_name": "Album"
}