kempersc/glam
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
glam/schemas/20251121/linkml/modules/classes/VideoPost.yaml
kempersc 095a3f949c refactor(linkml): apply RiC-O slot naming conventions to /schemas/ (Rule 39) 
Apply same RiC-O-style slot naming refactor to /schemas/20251121/linkml/
that was previously applied to frontend/public/schemas/:

- Add 'has_' prefix for possession predicates
- Add 'is_or_was_' prefix for temporal inverse relationships
- Add 'has_or_had_' for bidirectional temporal relations
- Add new slots: is_or_was_aggregated_by, is_or_was_allocated_by, etc.
- Update count slots with proper descriptions

This ensures consistency between the source schema directory and the
frontend-served schemas.

514 files changed, +6,325 insertions, -4,255 deletions
2026-01-10 12:55:45 +01:00

678 lines
20 KiB
YAML
Raw Blame History

id: https://nde.nl/ontology/hc/class/VideoPost
name: video_post_class
title: Video Post Class
imports:
- linkml:types
- ./SocialMediaPost
- ./SocialMediaPostTypes
- ../slots/language
- ../slots/aspect_ratio
- ../slots/available_caption_languages
- ../slots/caption_available
- ../slots/comment_author
- ../slots/comment_author_channel_id
- ../slots/comment_count
- ../slots/comment_id
- ../slots/comment_like_count
- ../slots/comment_published_at
- ../slots/comment_replies
- ../slots/comment_reply_count
- ../slots/comment_text
- ../slots/comment_updated_at
- ../slots/comments_fetched
- ../slots/default_audio_language
- ../slots/default_language
- ../slots/dislike_count
- ../slots/duration
- ../slots/favorite_count
- ../slots/frame_rate
- ../slots/is_embeddable
- ../slots/is_licensed_content
- ../slots/is_made_for_kids
- ../slots/like_count
- ../slots/live_broadcast_content
- ../slots/metrics_observed_at
- ../slots/specificity_annotation
- ../slots/template_specificity
- ../slots/video_category_id
- ../slots/video_comments
- ../slots/view_count
- ./SpecificityAnnotation
- ./TemplateSpecificityScores
- ./VideoComment
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
dcterms: http://purl.org/dc/terms/
prov: http://www.w3.org/ns/prov#
crm: http://www.cidoc-crm.org/cidoc-crm/
skos: http://www.w3.org/2004/02/skos/core#
as: https://www.w3.org/ns/activitystreams#
wd: http://www.wikidata.org/entity/
default_prefix: hc
classes:
VideoPost:
is_a: SocialMediaPost
class_uri: as:Video
abstract: false
description: |
Concrete class for video content with platform-specific properties.
**DEFINITION**:
VideoPost is a specialized SocialMediaPost for video content. It extends
the base post class with video-specific slots for duration, resolution,
captions, and engagement metrics.
**EXTENDS**: SocialMediaPost
This class adds:
- Video technical properties (duration, definition, aspect ratio)
- Caption and subtitle availability
- Engagement metrics (views, likes, comments)
- Platform-specific fields (YouTube category, live broadcast status)
- Temporal markers (chapters, segments)
**ONTOLOGY MAPPINGS**:
| Property | Activity Streams | Schema.org |
|----------|------------------|------------|
| Class | as:Video | schema:VideoObject |
| duration | as:duration | schema:duration |
| definition | - | schema:videoQuality |
| caption | - | schema:caption |
| view_count | - | schema:interactionStatistic |
**PLATFORM SUPPORT**:
| Platform | Duration Limit | Resolution | Captions |
|----------|----------------|------------|----------|
| YouTube | 12 hours (verified) | Up to 8K | VTT, SRT |
| Vimeo | Varies by plan | Up to 8K | VTT, SRT |
| Facebook | 4 hours | Up to 4K | Auto-generated |
| TikTok | 10 minutes | 1080p | Auto-generated |
| Instagram Reels | 90 seconds | 1080p | Auto-generated |
**HERITAGE INSTITUTION USE CASES**:
| Content Type | Typical Duration | Platform |
|--------------|------------------|----------|
| Virtual tours | 10-30 min | YouTube |
| Conservation docs | 5-20 min | YouTube, Vimeo |
| Curator interviews | 15-60 min | YouTube |
| Object spotlights | 2-5 min | YouTube, Instagram |
| Short clips | 15-60 sec | TikTok, Reels |
| Live recordings | 30-120 min | YouTube |
**METRICS OBSERVATION**:
Video metrics (views, likes, comments) are observational data that change
constantly. Each metric reading should include:
- `metrics_observed_at`: When metrics were recorded
- `retrieval_timestamp`: When API call was made
**RELATIONSHIP TO VideoPostType**:
- VideoPost is a **concrete post instance** with video content
- VideoPostType is a **type classification** for categorizing posts
- A VideoPost typically has `post_types: [VideoPostType]`
- But may also have multiple types: `[LiveStreamPostType, VideoPostType]`
**CAPTION AND SUBTITLE DISTINCTION**:
Related classes for textual content derived from video:
- VideoSubtitle: Time-coded text (SRT/VTT format)
- VideoTranscript: Full text without timestamps
- VideoAnnotation: Computer vision derived content
See VideoTextContent hierarchy for detailed modeling.
exact_mappings:
- as:Video
- schema:VideoObject
close_mappings:
- crm:E73_Information_Object
related_mappings:
- wikidata:Q34508
- wikidata:Q604644
slots:
- aspect_ratio
- available_caption_languages
- caption_available
- comment_count
- comments_fetched
- default_audio_language
- default_language
- definition
- dislike_count
- duration
- favorite_count
- frame_rate
- is_embeddable
- is_licensed_content
- is_made_for_kids
- like_count
- live_broadcast_content
- metrics_observed_at
- specificity_annotation
- template_specificity
- video_category_id
- video_comments
- view_count
slot_usage:
duration:
slot_uri: schema:duration
description: |
Duration of the video in ISO 8601 format.
Schema.org: duration for media length.
**Format**: ISO 8601 duration (e.g., "PT10M59S" = 10 minutes 59 seconds)
**Common Patterns**:
- PT30S = 30 seconds
- PT5M = 5 minutes
- PT1H30M = 1 hour 30 minutes
- PT2H15M30S = 2 hours 15 minutes 30 seconds
range: string
required: false
pattern: ^P(T(\d+H)?(\d+M)?(\d+S)?)?$
examples:
- value: PT10M59S
description: 10 minutes and 59 seconds
- value: PT1H30M
description: 1 hour 30 minutes
definition:
slot_uri: schema:videoQuality
description: |
Video resolution/definition quality.
Schema.org: videoQuality for resolution class.
**Values**:
- sd: Standard definition (480p or lower)
- hd: High definition (720p, 1080p)
- 4k: Ultra HD (2160p)
- 8k: Full Ultra HD (4320p)
range: VideoDefinitionEnum
required: false
examples:
- value: hd
description: High definition (720p/1080p)
has_aspect_ratio:
slot_uri: schema:width
description: |
Video aspect ratio.
**Common Values**:
- 16:9: Standard widescreen (YouTube default)
- 9:16: Vertical (Shorts, Reels, TikTok)
- 4:3: Classic TV format
- 1:1: Square (Instagram legacy)
- 21:9: Cinematic ultrawide
range: string
required: false
examples:
- value: '16:9'
description: Standard widescreen
- value: '9:16'
description: Vertical format for Shorts/Reels
frame_rate:
slot_uri: hc:frameRate
description: |
Video frame rate in frames per second.
**Common Values**:
- 24: Cinema standard
- 25: PAL standard
- 30: NTSC standard
- 60: High frame rate
range: float
required: false
examples:
- value: 30.0
description: 30 frames per second
caption_available:
slot_uri: schema:hasPart
description: |
Whether captions/subtitles are available for this video.
Indicates if the video has any caption tracks (auto-generated or manual).
Related: Use `available_caption_languages` for specific languages.
range: boolean
required: false
examples:
- value: true
description: Video has captions available
- value: false
description: No captions available
default_language:
slot_uri: schema:inLanguage
description: |
Default/primary language of the video content.
Schema.org: inLanguage for content language.
ISO 639-1 code (e.g., "nl", "en", "de").
Refers to on-screen text, title, description language.
range: string
required: false
examples:
- value: nl
description: Dutch language content
default_audio_language:
slot_uri: hc:defaultAudioLanguage
description: |
Language of the video's default audio track.
ISO 639-1 code. May differ from `default_language` for
dubbed or multilingual content.
range: string
required: false
examples:
- value: nl
description: Dutch audio track
has_available_caption_language:
slot_uri: hc:availableCaptionLanguages
description: |
List of languages for which captions are available.
ISO 639-1 codes for all caption tracks.
range: string
multivalued: true
required: false
examples:
- value:
- nl
- en
- de
description: Captions available in Dutch, English, German
view_count:
slot_uri: schema:interactionCount
description: |
Number of views for this video.
Schema.org: interactionCount for view statistic.
**OBSERVATIONAL**: This value changes constantly.
Always record `metrics_observed_at` timestamp.
range: integer
required: false
minimum_value: 0
examples:
- value: 132
description: 132 views at observation time
like_count:
slot_uri: hc:likeCount
description: |
Number of likes/upvotes for this video.
Platform-specific: YouTube likes, Facebook reactions, etc.
**OBSERVATIONAL**: Record with `metrics_observed_at`.
range: integer
required: false
minimum_value: 0
examples:
- value: 2
description: 2 likes at observation time
dislike_count:
slot_uri: hc:dislikeCount
description: |
Number of dislikes/downvotes (if available).
Note: YouTube hid public dislike counts in Nov 2021.
API may still return dislike data for channel owners.
range: integer
required: false
minimum_value: 0
comment_count:
slot_uri: hc:commentCount
description: |
Number of comments on this video.
**OBSERVATIONAL**: Record with `metrics_observed_at`.
range: integer
required: false
minimum_value: 0
examples:
- value: 0
description: No comments at observation time
favorite_count:
slot_uri: hc:favoriteCount
description: |
Number of times video was favorited/saved.
Platform-specific availability.
range: integer
required: false
minimum_value: 0
metrics_observed_at:
slot_uri: prov:atTime
description: |
Timestamp when engagement metrics were recorded.
PROV-O: atTime for observation timestamp.
**CRITICAL**: Metrics change constantly. This timestamp
indicates when view_count, like_count, etc. were observed.
range: datetime
required: false
examples:
- value: '2025-12-01T23:16:22.294232+00:00'
description: Metrics observed December 1, 2025
video_category_id:
slot_uri: hc:videoCategoryId
description: |
Platform-specific category identifier.
**YouTube Category IDs**:
- 1: Film & Animation
- 2: Autos & Vehicles
- 10: Music
- 15: Pets & Animals
- 17: Sports
- 19: Travel & Events
- 20: Gaming
- 22: People & Blogs
- 23: Comedy
- 24: Entertainment
- 25: News & Politics
- 26: Howto & Style
- 27: Education
- 28: Science & Technology
- 29: Nonprofits & Activism
range: string
required: false
examples:
- value: '22'
description: 'YouTube: People & Blogs'
- value: '27'
description: 'YouTube: Education'
live_broadcast_content:
slot_uri: hc:liveBroadcastContent
description: |
Live broadcast status of the video.
**Values**:
- none: Not a live broadcast (standard video)
- live: Currently broadcasting live
- upcoming: Scheduled live stream not yet started
When `live` or `upcoming` becomes `none`, video is archived.
range: LiveBroadcastStatusEnum
required: false
examples:
- value: none
description: Standard video (not live)
- value: live
description: Currently broadcasting
is_licensed_content:
slot_uri: hc:isLicensedContent
description: |
Whether the video contains licensed content (music, clips).
Affects monetization and regional availability.
range: boolean
required: false
is_embeddable:
slot_uri: hc:isEmbeddable
description: |
Whether the video can be embedded on external sites.
Publisher-controlled setting.
range: boolean
required: false
is_made_for_kids:
slot_uri: hc:isMadeForKids
description: |
Whether the video is designated as made for children.
COPPA compliance flag. Affects comments, ads, features.
range: boolean
required: false
comments_fetched:
slot_uri: hc:commentsFetched
description: |
Number of comments actually fetched/archived.
May be less than `comment_count` due to API limits,
deleted comments, or pagination.
range: integer
required: false
minimum_value: 0
examples:
- value: 0
description: No comments fetched
video_comments:
slot_uri: hc:videoComments
description: |
Collection of comments on this video.
Structured comment data with author, text, timestamp, likes.
Note: Comments may contain nested replies.
range: VideoComment
multivalued: true
required: false
inlined: true
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
comments:
- Extends SocialMediaPost with video-specific properties
- Maps to as:Video and schema:VideoObject
- Metrics are observational - always include metrics_observed_at
- Caption availability signals but not content (see VideoSubtitle)
- YouTube is primary platform for heritage institution video content
see_also:
- https://www.w3.org/ns/activitystreams#Video
- https://schema.org/VideoObject
- https://developers.google.com/youtube/v3/docs/videos
VideoComment:
class_uri: schema:Comment
description: |
A comment on a video post.
Models user-generated comments with author, text, timestamp,
and engagement metrics. Supports nested reply threads.
exact_mappings:
- schema:Comment
- as:Note
slots:
- comment_author
- comment_author_channel_id
- comment_id
- comment_like_count
- comment_published_at
- comment_replies
- comment_reply_count
- comment_text
- comment_updated_at
- specificity_annotation
- template_specificity
slot_usage:
comment_id:
slot_uri: dcterms:identifier
description: Unique identifier for the comment
range: string
required: true
comment_author:
slot_uri: schema:author
description: Display name of comment author
range: string
required: true
comment_author_channel_id:
slot_uri: hc:authorChannelId
description: Platform channel/account ID of author
range: string
required: false
comment_text:
slot_uri: schema:text
description: Full text content of the comment
range: string
required: true
comment_published_at:
slot_uri: dcterms:created
description: When comment was originally posted
range: datetime
required: true
comment_updated_at:
slot_uri: dcterms:modified
description: When comment was last edited
range: datetime
required: false
comment_like_count:
slot_uri: hc:likeCount
description: Number of likes on this comment
range: integer
required: false
minimum_value: 0
comment_reply_count:
slot_uri: hc:replyCount
description: Number of replies to this comment
range: integer
required: false
minimum_value: 0
comment_replies:
slot_uri: schema:comment
description: Nested reply comments
range: VideoComment
multivalued: true
required: false
inlined: true
specificity_annotation:
range: SpecificityAnnotation
inlined: true
template_specificity:
range: TemplateSpecificityScores
inlined: true
enums:
VideoDefinitionEnum:
description: |
Video resolution/definition quality categories.
Based on common platform standards.
permissible_values:
sd:
description: Standard definition (480p or lower)
hd:
description: High definition (720p, 1080p)
uhd:
description: Ultra HD (2160p/4K)
4k:
description: 4K resolution (2160p) - alias for uhd
8k:
description: Full Ultra HD (4320p)
LiveBroadcastStatusEnum:
description: |
Live broadcast status values for video content.
Based on YouTube API liveBroadcastContent values.
permissible_values:
none:
description: Not a live broadcast (standard uploaded video)
live:
description: Currently broadcasting live
upcoming:
description: Scheduled live stream that hasn't started yet
slots:
duration:
description: Duration in ISO 8601 format
range: string
definition:
description: Video resolution quality (sd, hd, 4k, 8k)
range: VideoDefinitionEnum
has_aspect_ratio:
description: Video aspect ratio (16:9, 9:16, 4:3, etc.)
range: string
frame_rate:
description: Frame rate in FPS
range: float
caption_available:
description: Whether captions are available
range: boolean
default_language:
description: Default/primary language of the video content
range: string
slot_uri: schema:inLanguage
default_audio_language:
description: Language of default audio track
range: string
has_available_caption_language:
description: Languages for which captions exist
range: string
multivalued: true
view_count:
description: Number of views
range: integer
like_count:
description: Number of likes
range: integer
dislike_count:
description: Number of dislikes
range: integer
comment_count:
description: Number of comments
range: integer
favorite_count:
description: Number of favorites/saves
range: integer
metrics_observed_at:
description: When metrics were recorded
range: datetime
video_category_id:
description: Platform category identifier
range: string
live_broadcast_content:
description: Live broadcast status
range: LiveBroadcastStatusEnum
is_licensed_content:
description: Contains licensed content
range: boolean
is_embeddable:
description: Can be embedded externally
range: boolean
is_made_for_kids:
description: COPPA kids content flag
range: boolean
comments_fetched:
description: Number of comments actually retrieved
range: integer
video_comments:
description: Collection of video comments
range: VideoComment
multivalued: true
comment_id:
description: Unique comment identifier
range: string
comment_author:
description: Comment author display name
range: string
comment_author_channel_id:
description: Author's channel/account ID
range: string
comment_text:
description: Comment text content
range: string
comment_published_at:
description: When comment was posted
range: datetime
comment_updated_at:
description: When comment was edited
range: datetime
comment_like_count:
description: Likes on this comment
range: integer
comment_reply_count:
description: Number of replies
range: integer
comment_replies:
description: Nested reply comments
range: VideoComment
multivalued: true
Reference in a new issue View git blame Copy permalink