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.