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