New properties proposed for live event content

Open
#4,530 7 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
30/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Stale
Domain
data

Research direction

The issue names no repository files or tests. Start by reviewing the BroadcastEvent and SportsEvent definitions and the proposed property types; resolve the open Text-versus-Enumeration choice for programActuality. Done means the proposal has an agreed design and the six vocabulary properties are added with their stated domains and ranges.

Written by the indexing model from the issue text.

Description

no-issue-activity

The current schema.org vocabulary, while excellent for VOD content, has several gaps that prevent it from being a comprehensive standard for ingesting modern, OTT and broadcast schedules from major content providers.
The core problem we found is that live broadcasts involve multiple layers of timing (e.g., the broadcast window vs. the actual event), complex regional rights and embargoes, and a variety of audio tracks (e.g., home/away commentary) that the current schema does not adequately support.
This proposal introduces a set of new properties, primarily for the BroadcastEvent and SportsEvent types, to address these gaps.

New properties to add to schema.org:

  • eventSchedule on type BroadcastEvent Expected type is Schedule
    Distinguishes the precise start and end of the core event (e.g., kick-off to final whistle) from the wider startDate/endDate of the broadcast window (which includes pre/post-show content).
  • programActuality on type BroadcastEvent Expected type is either Text or Enumeration (still under discussion)
    A flag to indicate the airing status of the program. Values include Live, Premiere, New, Repeat, and Delayed.
  • broadcastImage on type BroadcastEvent Expected type is ImageObject
    Provides a set of images specific to an individual broadcast, allowing for tune-in creative or overlays. This is distinct from the image property of the underlying program.
  • audioTrack on type BroadcastEvent Expected type is AudioObject
    A structured object to provide detailed information about an available audio stream, including language, codec, a descriptive name (e.g., "Home Commentary"), and a stream PID.
  • regionalAudioPreferences on type BroadcastEvent Expected type is AudioConfiguration
    Defines a different default audio track or an ordered list of fallback preferences for specific geographic regions.
  • gameId on type SportsEvent Expected type is Text
    A league-specific, official identifier for a sports game (e.g., an NFL-provided Game ID).
Dominant language
HTML
Stars
6.3k
Forks
962
Avg merge
18h 7m
Merged PRs (30d)
9

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from schemaorg/schemaorg

All issues in schemaorg/schemaorg

Similar issues

More Data Engineering issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.