Skip to main content

YouTube — Data Mapping

B
Written by Ben Keeling

The objects we sync from your YouTube channel, the exact fields we read for each, and how they map into Medialake.


Medialake reads your channel's playlists to let you choose what to sync, and syncs the videos inside them — each becoming a file carrying its metadata and thumbnail — along with each video's organic metrics. Everything is read-only, via Google's official YouTube Data API (v3). We only read the fields listed on this page, nothing else.

Objects at a glance

YouTube object

What it is

Why we sync it

The connected YouTube channel

Identifies the connection and anchors everything beneath it

Your channel's groupings of videos

The folder structure you browse and select from — plus an "All videos" option

The videos themselves

Medialake ingests these as files — carrying the metadata and thumbnail

Video statistics

Views, likes, comments per video

Become Medialake metrics — see Metrics Reference

Channel

Read once at connection time to identify who connected and to anchor the sync.

Fields we read: the channel's snippet (name, thumbnails), contentDetails, and statistics.

Playlists

Read live from the API so you can browse and select what to sync — alongside an "All videos" option covering the channel's full library. Only your selections are kept.

Fields we read: each playlist's snippet (title, thumbnail) and ID.

Videos

Each video in your selected playlists becomes a file in Medialake, carrying its metadata and thumbnail.

Fields we read: the video's ID and snippet (title, thumbnails — the thumbnail also gives us the display resolution), plus its status (privacy and upload state) so Medialake can flag videos that become unavailable, and the video's public URL and channel context.

How it maps into Medialake

Channel└─ Playlist  ("All videos" or your selections)└─ Video ──── organic metrics (views, likes, comments)└─ File (metadata + thumbnail)

Everything on this page is read-only — see Authentication for the permission behind it.

Further reading (Google documentation)


Questions about a specific field? Contact [email protected].

Did this answer your question?