- Family Graph API
- Objects
- AggregateValueAdd
- Album
- Audio
- BuyNowData
- ChildInFamily
- Citation
- ColorizationData
- Comment
- Config
- ConfirmationStatus
- Counter
- Device
- DiscoveryBase
- DnaAncestorName
- DnaEnums
- DnaEthnicity
- DnaEthnicityReport
- DnaKit
- DnaKitFile
- DnaMatch
- DnaMatchCommonAncestor
- DnaMatchNote
- DnaMatchRelationship
- DnaOrderItemShippingDetails
- Document
- Enums
- EthnicityInLocation
- Event
- EventDate
- EventPlace
- ExportGEDCOM
- ExportGEDCOMStatus
- Family
- FamilyEvent
- GenealogyEvent
- GoalActivity
- Image
- Individual
- Installation
- Invitation
- MatchesCount
- MatchingRequest
- MediaItem
- Membership
- Navigation
- NavigationItem
- NavigationItemBadge
- NewPhotoInfo
- Note
- Notification
- NotificationHistory
- OrderItemCoupon
- OrderItemShippingDetails
- Page
- PersonalPhotosDiscovery
- Phones
- Photo
- PhotoVersion
- Range
- RecordColorizationData
- RecordIndividual
- RecordMatchesCount
- Relationship
- ResiEvent
- ShippingOption
- SingleDate
- Site
- SmartMatch
- Source
- StructuredDate
- StructuredPlace
- SubTree
- SuggestedRelative
- System
- Tag
- ThreadsCount
- Tree
- TreeItem
- User
- UserMenu
- ValueAddData
- ValueAddElement
- ValueAddFactor
- Video
- WorldEthnicities
- SDKs
- PHP SDK
- iOS SDK
- Android SDK
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"
}