- Family Graph API
- Objects
- AggregateValueAdd
- Album
- Audio
- BuyNowData
- ChildInFamily
- Citation
- ColorizationData
- Comment
- Config
- ConfirmationStatus
- Counter
- Device
- DiscoveryBase
- DnaAncestorName
- DnaEnums
- DnaEthnicity
- DnaEthnicityReport
- DnaKit
- DnaKitFile
- DnaLabel
- 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
Audio
An audio file as represented in the Family Graph API.
A family site can include media items such as photos, documents, videos, and audio files. Individuals and events in the family tree can be associated to audio files and other media items using tags. An audio file is accessible via a url. Audio files and other media items can be organized in albums in the family site.
Fields
The Audio
object contains the following fields:
Name | Description | Type | Access Mode |
id |
The audio file id |
id |
read |
type |
The media item type |
string |
read |
name |
The audio file name (title) |
string |
read, write |
date |
When the audio file was recorded |
EventDate object: gedcom, text, date, structured_date and class_name fields |
read, write |
place |
Where the audio file was recorded |
string |
read, write |
description |
The audio file description |
string |
read, write |
link |
Link to audio file on MyHeritage.com |
string |
read |
url |
The url for the audio file |
string |
read |
thumbnails |
Required by base MediaItem, but not implemented |
array of Image objects containing the url, width, height and class_name fields |
read |
extension |
The extension of the audio file name |
string |
read |
duration |
The duration of the audio file (HH:MM:SS) |
string |
read |
submitter |
The user who submitted the audio file to the site |
User object: id and name fields |
read |
created_time |
The time when the audio file was submitted to the site |
string (YYYY-MM-DD HH:MM:SS) |
read |
updated_time |
The date and time when the audio file was last updated on the site |
string (YYYY-MM-DD HH:MM:SS) |
read |
site |
The site of the audio file |
Site object: id and name fields |
read |
source |
Id of the audio file part in format 'cid:<filename>' |
string |
write |
class_name |
The object class name |
string |
read |
Connections
The Audio object contains the following connections:Name | Description | Type | Access Mode |
keywords |
Keywords associated with the audio file |
array of strings |
read |
items |
List of objects that are associated with the audio file (individuals, families, events, family events and sources) |
array of TreeItem objects |
read |
albums |
List of albums the audio file is in |
array of Album objects |
read |
tags |
List of tags of individuals in the audio file |
array of Tag objects |
read |
comments |
List of comments associated with the media item |
array of Comment objects |
read |
Example
https://familygraph.myheritage.com/audio-144530322-1-1 (open in browser){
"id": "audio-144530322-1-1",
"type": "audio",
"name": "asknot",
"link": "https:\/\/www.myheritage.com\/audio-1_144530322_144530322\/asknot",
"url": "https:\/\/sites-cf.mhcache.com\/e\/1\/WC1BbXotQ29udGVudC1TaGEyNTY9VU5TSUdORUQtUEFZTE9BRCZYLUFtei1DcmVkZW50aWFsPUFLSUFYRDZIUllIRUlUVzRHV0VCJTJGMjAyMjA2MjclMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjIwNjI3VDA0MDAwMFomWC1BbXotRXhwaXJlcz02MDQ4MDAmWC1BbXotU2lnbmF0dXJlPWUwZDQzZDZhNGY4N2EzOGE5Nzg2NGU3ZWI4YmRhYmVhYjIxZWViMGFiYmRkOWU2OTdmMjUyNDhhYTJmN2JkYzY%3D\/014\/453\/0322\/000001_014600em83i3l5d462ce4u_D.mp3",
"extension": "mp3",
"duration": "00:00:10",
"submitter": {
"id": "user-10",
"name": "Developer MyHeritage"
},
"created_time": "2011-08-23T15:10:33+0000",
"updated_time": "2011-08-23T15:10:33+0000",
"site": {
"id": "site-144530322",
"name": "Demo Family Site"
},
"class_name": "Audio"
}