Video property for programmes and events

[nickevansuk]

Proposer

England Netball

Use Case

"as a potential participant, I want to see a video that shows what I can expect to see at an event"

Why is this not covered by existing properties?

There is currently no property to specify a video

Please provide a link to example data

Explainer for Back to Netball: https://www.youtube.com/watch?v=N268gBOvnzo

Explainer for Walking Netball programme: https://www.youtube.com/watch?v=qzQfnv7sFPg

Explainer for Netball Youth Camp programme: https://www.youtube.com/watch?v=lvlEpaKTotQ

Proposal

video: to be added to Brand (used within "programme"), to Event and to Organization, and constrained to an array of VideoObject in line with the OpenActive profile of the image property.

Example

"programme": {
  "type": "Brand",
  "name": "Back to Netball",
  "description": "Running across England since 2010, over 60,000 women have taken part in Back to Netball and realised the benefits of getting involved.  From losing weight, developing the body’s cardiovascular system and improving muscle tone, taking part in Back to Netball is great for you in so many ways.\r\n\r\nBack to Netball sessions are running across England and provide women of all ages with a gentle re-introduction to the sport.  Run by passionate and enthusiastic coaches, sessions cover the basics of the game including passing, footwork and shooting.  Sessions finish with a friendly game to put the skills you have learnt into practice.\r\n\r\nYou don’t need any special kit, just clothes that you feel comfortable exercising in and trainers ideally that lace up. Make sure you bring some water and that you’ve had a snack a couple of hours before hand, something like our lovely sponsors Mrs Crimbles flapjacks or a banana so you’ve got plenty of energy.",
  "logo": "http://hertsnetball.co.uk/js/plugins/imagemanager/files/B2N_logo.jpg", 
  "url": "https://www.englandnetball.co.uk/backtonetball/", 
  "video": [
    {
      "type": "VideoObject",
      "description": "Video explanation of the programme",
      "url": "https://www.youtube.com/watch?v=N268gBOvnzo",
      "duration": "T1M33S",
      "name": "What is Back to Netball?",
      "thumbnail": "http://example.com/js/plugins/imagemanager/files/video.png"
    }
  ]
}

Beta property

"beta:video"

[ldodds]

The video property is currently not defined for Brand or Thing, its for CreativeWork or variants.

subjectOf looks like the most appropriate use in Schema.org. Perhaps we can instead add this use case to https://github.com/schemaorg/schemaorg/issues/1670 in order to move that forward and out of pending?

In the meantime we could add it to our context rather than defining a new custom property.

[nickevansuk]

My comment on this would be: given that the web platform is moving towards native video in general (it's already there in HTML5), schema.org should allow video in the same way as it does image on the Thing type.

I can see why it's tempting to classify a video as a CreativeWork, and link it loosely with Event, however we should then do the same for images for consistency and use subjectOf to access both from Event... I suggest we should be looking for consistency in the other direction instead.

Also using subjectOf to access videos (or images) is much less intuitive to a data consumer.

The general consensus of https://github.com/schemaorg/schemaorg/issues/1447 and with evidence here seems to be in agreement with this, and there's even a pull request that already exists to do this too.

[nickevansuk]

Noting continuing discussion here: https://github.com/schemaorg/schemaorg/pull/1774