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:\/\/www.myheritageimages.com\/D\/storage\/site144530322\/files\/00\/00\/01\/000001_014600em83i3l5d462ce4u.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"
}