glam/frontend/public/schemas/20251121/linkml/modules/classes/YoutubeEnrichment.yaml

150 lines
4.9 KiB
YAML

# YoutubeEnrichment - YouTube channel and video data for the institution (suppo...
# Extracted from custodian_source.yaml per Rule 38 (modular schema files)
# Extraction date: 2026-01-08
id: https://nde.nl/ontology/hc/classes/YoutubeEnrichment
name: YoutubeEnrichment
title: YoutubeEnrichment
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
prov: http://www.w3.org/ns/prov#
xsd: http://www.w3.org/2001/XMLSchema#
dcat: http://www.w3.org/ns/dcat#
imports:
- linkml:types
- ./LLMVerification
- ./RelatedYoutubeVideo
- ./YoutubeChannel
- ./YoutubeProvenance
- ./YoutubeSocialLink
- ./YoutubeVideo
default_range: string
classes:
YoutubeEnrichment:
description: >-
YouTube channel and video data for a heritage institution, supporting
both flat and nested data formats. Includes channel metadata, videos,
social links, and LLM verification results.
Ontology mapping rationale:
- class_uri is prov:Entity because YouTube enrichment data is a
provenance-tracked entity derived from YouTube API.
- close_mappings includes dcat:Dataset as the enrichment represents
a dataset of YouTube information.
- related_mappings includes schema:BroadcastChannel for the channel
aspect and prov:Collection for the video collection.
class_uri: prov:Entity
close_mappings:
- dcat:Dataset
related_mappings:
- schema:BroadcastChannel
- prov:Collection
attributes:
source_url:
range: uri
description: YouTube channel URL
fetch_timestamp:
range: datetime
has_or_had_api_endpoint:
range: uri
description: YouTube Data API endpoint
has_api_version:
range: string
description: API version (v3)
identifier_type:
range: string
description: Type of identifier (channel_id, handle, etc.)
identifier_value:
range: string
description: The identifier value
status:
range: string
description: Enrichment status
error:
range: string
description: Error message if enrichment failed
videos_count:
range: integer
description: Number of videos retrieved
channel:
range: YoutubeChannel
description: Channel metadata (nested format)
videos:
range: YoutubeVideo
multivalued: true
inlined_as_list: true
channel_id:
any_of:
- range: string
- range: string
multivalued: true
inlined_as_list: true
description: YouTube channel ID(s) (flat format)
channel_url:
range: uri
description: YouTube channel URL (flat format)
title:
range: string
description: Channel title (flat format)
enrichment_description:
range: string
description: Channel description (flat format)
custom_url:
range: string
description: Custom URL handle (flat format)
published_at:
range: datetime
description: Channel creation date (flat format)
has_iso_3166_1_alpha_2_code:
range: string
description: ISO 3166-1 alpha-2 country code (2-letter, e.g., NL, US, JP)
thumbnail_url:
range: uri
description: Thumbnail URL (flat format)
subscriber_count:
range: integer
description: Subscriber count (flat format)
video_count:
range: integer
description: Video count (flat format)
view_count:
range: integer
description: View count (flat format)
api_status:
range: string
description: API status (MANUAL_ENTRY, SUCCESS, FAILED, etc.)
channel_title:
range: string
description: Channel title (alternative to title)
channel_description:
range: string
description: Channel description (alternative to description)
llm_verification:
range: LLMVerification
description: LLM-based channel verification results
provenance:
range: YoutubeProvenance
description: Source provenance information
videos_fetch_timestamp:
range: datetime
description: When videos were fetched
related_videos:
range: RelatedYoutubeVideo
multivalued: true
inlined_as_list: true
description: Related videos about this institution from other channels
description_arabic:
range: string
description: Channel description in Arabic
social_links:
range: YoutubeSocialLink
multivalued: true
inlined_as_list: true
description: Social media and website links from YouTube channel