Playlists

Un recurso playlist representa una lista de reproducción de YouTube. Una lista de reproducción es una colección de videos que se pueden ver de manera sucesiva y compartir con otros usuarios. Una lista de reproducción puede contener hasta 200 videos. YouTube no limita el número de listas de reproducción que puede crear cada usuario. Gracias a una configuración predeterminada, las listas de reproducción son visibles públicamente a otros usuarios; sin embargo, pueden ser públicas o privadas.

YouTube también utiliza listas de reproducción para identificar colecciones especiales de videos de un canal, por ejemplo:

  • videos subidos
  • videos favoritos
  • videos con calificación positiva (me gusta)
  • historial de reproducciones
  • ver más tarde
Para ser más específicos, estas listas están asociadas a un canal, que es una colección de videos, listas de reproducción e información adicional de YouTube de una persona, grupo o empresa. Puedes recuperar los ID de listas de reproducción para cada una de estas listas de channel resource para un canal determinado.

Luego, puedes utilizar el método playlistItems.list para recuperar cualquiera de esas listas. También puedes agregar o eliminar elementos de esas listas invocando los métodos playlistItems.insert y playlistItems.delete.

Métodos

La API admite los siguientes métodos para los recursos de playlists:

list
Muestra una colección de listas de reproducción que coinciden con los parámetros de solicitud de la API. Por ejemplo, puedes recuperar todas las listas de reproducción pertenecientes al usuario autenticado o puedes recuperar una o varias listas de reproducción con sus ID únicos. Pruébalo ahora.
insert
Crea una lista de reproducción. Pruébalo ahora.
update
Modifica una lista de reproducción. Por ejemplo, puede cambiar el título, la descripción o el estado de la privacidad. Pruébalo ahora.
delete
Elimina una lista de reproducción. Pruébalo ahora.

Representación de recursos

La estructura JSON a continuación muestra el formato de un recurso de playlists:

{
  "kind": "youtube#playlist",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "tags": [
      string
    ]
  },
  "status": {
    "privacyStatus": string
  },
  "contentDetails": {
    "itemCount": unsigned integer
  },
  "player": {
    "embedHtml": string
  }
}

Propiedades

La siguiente tabla define las propiedades que aparecen en este recurso:

Propiedades
kind string
Tipo de recurso de la API. El valor será youtube#playlist.
etag etag
Etag de este recurso.
id string
ID que YouTube utiliza para identificar de forma exclusiva la lista de reproducción.
snippet object
El objeto snippet contiene información básica sobre la lista de reproducción, como el título y la descripción.
snippet.publishedAt datetime
Fecha y hora en que se creó la lista de reproducción. El valor se especifica en el formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.channelId string
ID que YouTube utiliza para identificar de forma exclusiva el canal que publicó la lista de reproducción.
snippet.title string
Título de la lista de reproducción.
snippet.description string
Descripción de la lista de reproducción.
snippet.thumbnails object
Mapa de imágenes en miniatura asociadas con la lista de reproducción. Para cada objeto en el mapa, la clave es el nombre de la imagen en miniatura, y el valor es un objeto que contiene otra información sobre la viñeta.
snippet.thumbnails.(key) object
Los valores de clave válidos son:
  • default: Imagen en miniatura predeterminada. La viñeta predeterminada de un video, o de un recurso que se refiere a un video, como un elemento de una lista de reproducción o el resultado de una búsqueda, es de 120 píxeles de ancho y 90 píxeles de alto. La viñeta predeterminada para un canal es de 88 píxeles de ancho y 88 píxeles de alto.
  • medium: Versión de mayor resolución de la imagen en miniatura. Para un video (o un recurso que hace referencia a un video), esta imagen es de 320 píxeles de ancho y 180 píxeles de alto. Para un canal, esta imagen es de 240 píxeles de ancho y 240 píxeles de alto.
  • high: Versión de alta resolución de la imagen en miniatura. Para un video (o un recurso que hace referencia a un video), esta imagen es de 480 píxeles de ancho y 360 píxeles de alto. Para un canal, esta imagen es de 800 píxeles de ancho y 800 píxeles de alto.
snippet.thumbnails.(key).url string
URL de la imagen.
snippet.thumbnails.(key).width unsigned integer
Ancho de la imagen.
snippet.thumbnails.(key).height unsigned integer
Altura de la imagen.
snippet.channelTitle string
Título del canal al que pertenece el video.
snippet.tags[] list
Etiquetas de palabras clave asociadas con la lista de reproducción.
status object
El status contiene información sobre el estado de la lista de reproducción.
status.privacyStatus string
Estado de privacidad de la lista de reproducción.

Los valores válidos para esta propiedad son:
  • private
  • public
  • unlisted
contentDetails object
El objeto contentDetails presenta información sobre el contenido de una lista de reproducción, incluido el número de videos de la lista de reproducción.
contentDetails.itemCount unsigned integer
Número de videos en la lista de reproducción.
player object
El objeto player contiene información que puedes utilizar para reproducir la lista de reproducción en un reproductor insertado.
player.embedHtml string
Etiqueta <iframe> que inserta un reproductor que reproducirá la lista de reproducción.