Video

A video as represented in the Family Graph API.

A family site can include media items such as photos, documents, videos, and audios. Individuals and events in the family tree can be associated to videos and other media items using tags. A video contains a file that is accessible via a url. Videos and other media items can be organized in albums in the family site.

Fields

The Video object contains the following fields:

Name	Description	Type	Access Mode
id	The video's id	id	read
type	The media item type	string	read
name	The video's name (title)	string	read, write
date	When the video was taken	EventDate object: gedcom, text, date, structured_date and class_name fields	read, write
place	Where the video was taken	string	read, write
description	The video's description	string	read, write
link	Link to video on MyHeritage.com	string	read
url	The url for the video	string	read
thumbnails	List of different thumbnails of different sizes for the video	array of Image objects containing the url, width, height and class_name fields	read
width	The width of the video in pixels	int	read
height	The height of the video in pixels	int	read
extension	The extension of the video's file name	string	read
duration	The duration of the video (HH:MM:SS)	string	read
submitter	The user who submitted the video to the site	User object: id and name fields	read
created_time	The time when the video was submitted to the site	string (YYYY-MM-DD HH:MM:SS)	read
updated_time	The date and time when the video was last updated on the site	string (YYYY-MM-DD HH:MM:SS)	read
site	The site of the video	Site object: id and name fields	read
source	Id of the video file part in format 'cid:<filename>'	string	write
class_name	The object class name	string	read

Connections

The Video object contains the following connections:

Name	Description	Type	Access Mode
keywords	Keywords associated with the video	array of strings	read
items	List of objects that are associated with the video (individuals, families, events, family events and sources)	array of TreeItem objects	read
albums	List of albums the video is in	array of Album objects	read
tags	List of tags of individuals in the video	array of Tag objects	read
comments	List of comments associated with the video	array of Comment objects	read

Example

https://familygraph.myheritage.com/video-144530322-1-1000394 (open in browser)

{
	"id": "video-144530322-1-1000394",
	"type": "video",
	"name": "JFKatRice",
	"link": "https:\/\/www.myheritage.com\/video-1000394_144530322_144530322\/jfkatrice",
	"url": "https:\/\/www.myheritageimages.com\/D\/storage\/site144530322\/files\/00\/03\/94\/000394_7468270bb32w7fd68bn824.flv",
	"thumbnails": [
		{
			"url": "https:\/\/www.myheritageimages.com\/D\/storage\/site144530322\/files\/00\/03\/94\/000394_85223626w3vb24g3vb7fdp.jpg",
			"width": 160,
			"height": 120,
			"class_name": "Image"
		},
		{
			"url": "https:\/\/thumbnail.myheritageimages.com\/530\/322\/144530322\/000\/000394_85223626w3vb24g3vb7fdp_D_40x30.jpg",
			"width": 40,
			"height": 30,
			"class_name": "Image"
		}
	],
	"width": 160,
	"height": 120,
	"extension": "flv",
	"duration": "00:00:08",
	"submitter": {
		"id": "user-10",
		"name": "Developer MyHeritage"
	},
	"created_time": "2011-03-03T16:01:01+0000",
	"updated_time": "2011-03-03T16:01:01+0000",
	"site": {
		"id": "site-144530322",
		"name": "Demo Family Site"
	},
	"class_name": "Video"
}