Youtube · Schema

Playlist

A playlist resource represents a YouTube playlist.

GoogleMediaSocialStreamingVideoVideos

Properties

Name	Type	Description
kind	string	Identifies the API resource's type. Value is youtube#playlist.
etag	string	The Etag of this resource.
id	string	The ID that YouTube uses to uniquely identify the playlist.
snippet	object	Basic details about the playlist such as its title, description, and thumbnails.
status	object	The status object contains status information for the playlist.
contentDetails	object	The contentDetails object contains information about the playlist content.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/Playlist",
  "title": "Playlist",
  "type": "object",
  "description": "A playlist resource represents a YouTube playlist.",
  "required": [
    "kind",
    "etag"
  ],
  "properties": {
    "kind": {
      "type": "string",
      "description": "Identifies the API resource's type. Value is youtube#playlist.",
      "default": "youtube#playlist",
      "example": "youtube#video"
    },
    "etag": {
      "type": "string",
      "description": "The Etag of this resource.",
      "example": "XI7nbFXulYBIpL0ayR_gDh3eu1k"
    },
    "id": {
      "type": "string",
      "description": "The ID that YouTube uses to uniquely identify the playlist.",
      "example": "abc123def456"
    },
    "snippet": {
      "type": "object",
      "description": "Basic details about the playlist such as its title, description, and thumbnails.",
      "properties": {
        "publishedAt": {
          "type": "string",
          "format": "date-time",
          "description": "The date and time that the playlist was created."
        },
        "channelId": {
          "type": "string",
          "description": "The ID of the channel that published the playlist."
        },
        "title": {
          "type": "string",
          "description": "The playlist title."
        },
        "description": {
          "type": "string",
          "description": "The playlist description."
        },
        "thumbnails": {
          "type": "object",
          "description": "A map of thumbnail images associated with the playlist."
        },
        "channelTitle": {
          "type": "string",
          "description": "The channel title of the channel that the video belongs to."
        },
        "tags": {
          "type": "array",
          "description": "Keyword tags associated with the playlist.",
          "items": {
            "type": "string"
          }
        },
        "defaultLanguage": {
          "type": "string",
          "description": "The language of the text in the playlist resource's snippet.title and snippet.description properties."
        }
      },
      "example": "example_value"
    },
    "status": {
      "type": "object",
      "description": "The status object contains status information for the playlist.",
      "properties": {
        "privacyStatus": {
          "type": "string",
          "description": "The playlist's privacy status.",
          "enum": [
            "private",
            "public",
            "unlisted"
          ]
        }
      },
      "example": "example_value"
    },
    "contentDetails": {
      "type": "object",
      "description": "The contentDetails object contains information about the playlist content.",
      "properties": {
        "itemCount": {
          "type": "integer",
          "description": "The number of videos in the playlist."
        }
      },
      "example": "example_value"
    }
  }
}