# 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)
        api_endpoint:
          range: uri
          description: YouTube Data API endpoint (alternate field name)
        api_version:
          range: string
          description: API version (v3) (alternate field name)
        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
        country:
          range: string
          description: Country of the YouTube channel (ISO 3166-1 alpha-2 code)
        description:
          range: string
          description: Channel description (simplified alias)