glam/schemas/20251121/linkml/modules/classes/DigitalPlatformUserIdentifier.yaml
kempersc ca4a54181e Refactor schema files to improve clarity and maintainability
- Updated WorldCatIdentifier.yaml to remove unnecessary description and ensure consistent formatting.
- Enhanced WorldHeritageSite.yaml by breaking long description into multiple lines for better readability and removed unused attributes.
- Simplified WritingSystem.yaml by removing redundant attributes and ensuring consistent formatting.
- Cleaned up XPathScore.yaml by removing unnecessary attributes and ensuring consistent formatting.
- Improved YoutubeChannel.yaml by breaking long description into multiple lines for better readability.
- Enhanced YoutubeEnrichment.yaml by breaking long description into multiple lines for better readability.
- Updated YoutubeVideo.yaml to break long description into multiple lines and removed legacy field name.
- Refined has_or_had_affiliation.yaml by removing unnecessary comments and ensuring clarity.
- Cleaned up is_or_was_retrieved_at.yaml by removing unnecessary comments and ensuring clarity.
- Added rules for generic slots and avoiding rough edits in schema files to maintain structural integrity.
- Introduced changes_or_changed_through.yaml to define a new slot for linking entities to change events.
2026-01-31 00:46:23 +01:00

102 lines
4.3 KiB
YAML

id: https://nde.nl/ontology/hc/class/DigitalPlatformUserIdentifier
name: digital_platform_user_identifier_class
title: Digital Platform User Identifier Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
dcterms: http://purl.org/dc/terms/
foaf: http://xmlns.com/foaf/0.1/
as: https://www.w3.org/ns/activitystreams#
imports:
- linkml:types
- ../metadata
- ../slots/has_or_had_identifier
- ../slots/has_or_had_label
- ./Identifier
default_prefix: hc
classes:
DigitalPlatformUserIdentifier:
is_a: Identifier
class_uri: hc:DigitalPlatformUserIdentifier
description: 'Identifier for a user account on a digital platform (YouTube, Twitter, etc.). **PURPOSE**: Structured representation
of platform-specific user identifiers, such as YouTube channel IDs, Twitter handles, or Instagram usernames. Replaces
simple string channel_id slots with typed identifiers. **DESIGN RATIONALE**: Created per slot_fixes.yaml migration from
`comment_author_channel_id` string to structured `has_or_had_author` + `Author` with `has_or_had_identifier` + `DigitalPlatformUserIdentifier`
for platform user identification. **PLATFORM IDENTIFIER TYPES**: | Platform | Identifier Type | Example | |----------|-----------------|---------|
| YouTube | Channel ID | UC1234abcdef | | Twitter/X | User ID | 12345678 | | Instagram | Username | @museum_account
| | Facebook | Page ID | 123456789 | | LinkedIn | Company ID | heritage-foundation | | TikTok | User ID | museum_official
| **ONTOLOGY ALIGNMENT**: | Ontology | Class/Property | Usage | |----------|----------------|-------| | **Dublin Core**
| `dcterms:identifier` | Base identifier semantics | | **Schema.org** | `schema:identifier` | Web-standard identifier
| | **FOAF** | `foaf:OnlineAccount` | Online account modeling | | **Activity Streams** | `as:Person` | Social media
activity | '
exact_mappings:
- foaf:OnlineAccount
close_mappings:
- schema:identifier
related_mappings:
- dcterms:identifier
- as:actor
attributes:
platform_type:
description: 'Type of digital platform (YouTube, Twitter, Instagram, etc.). '
range: string
required: true
examples:
- value: youtube
- value: twitter
- value: instagram
- value: facebook
- value: linkedin
- value: tiktok
platform_user_id:
description: 'Platform-specific user/channel/account identifier. '
range: string
required: true
examples:
- value: UC1234abcdefghijk
description: YouTube channel ID
- value: '12345678'
description: Twitter numeric user ID
- value: museum_official
description: TikTok username
platform_username:
description: 'Human-readable username or handle on the platform. May differ from platform_user_id. '
range: string
required: false
examples:
- value: '@rijksmuseum'
description: Twitter handle
- value: MuseumFan2024
description: YouTube display name
profile_url:
description: 'URL to the user''s profile page on the platform. '
range: uri
required: false
examples:
- value: https://www.youtube.com/channel/UC1234abcdef
- value: https://twitter.com/rijksmuseum
slot_usage:
ifabsent: string(digital_platform_user_id)
examples:
- value:
platform_type: youtube
profile_url: https://www.youtube.com/channel/UCsT0YIqwnpJCM-mx7-gSA4Q
- value:
platform_type: twitter
profile_url: https://twitter.com/rijksmuseum
- value:
platform_type: youtube
comments:
- Created per slot_fixes.yaml migration from comment_author_channel_id (2026-01-22)
- Extends Identifier class with platform-specific fields
- Use for identifying users/authors on digital platforms
- Supports YouTube, Twitter, Instagram, Facebook, LinkedIn, TikTok
see_also:
- http://xmlns.com/foaf/0.1/OnlineAccount
- https://www.w3.org/ns/activitystreams
- https://developers.google.com/youtube/v3/docs/channels
annotations:
specificity_score: 0.7
specificity_rationale: Specific to digital platform user identification contexts.
custodian_types: '[''*'']'