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"
}