Playlists

Un recurso playlist representa una playlist 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. 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 usa playlists para identificar colecciones especiales de videos para un canal, por ejemplo:

• videos subidos
• videos con calificación positiva (me gusta)

Para ser más específicos, estas listas están asociadas a un canal, que es una colección de los videos, las playlists y otra información de YouTube de una persona, un grupo o una empresa. Puedes recuperar los ID de playlists para cada una de estas listas desde channel resource para un canal determinado.

Luego, puedes usar el método playlistItems.list para recuperar cualquiera de esas listas. También puedes agregar o quitar elementos de esas listas llamando a los métodos playlistItems.insert y playlistItems.delete.

Métodos

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

list

Muestra una colección de playlists que coinciden con los parámetros de solicitud a 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ébala ahora.

insertar

Crea una playlist. Pruébala ahora.

actualizar

Modifica una playlist. Por ejemplo, puede cambiar el título, la descripción o el estado de la privacidad. Pruébala ahora.

borrar

Borra una playlist. Pruébala ahora.

Representación de recursos

En la siguiente estructura JSON, se muestra el formato de un recurso 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,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    }
  },
  "status": {
    "privacyStatus": string
  },
  "contentDetails": {
    "itemCount": unsigned integer
  },
  "player": {
    "embedHtml": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

Propiedades

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

Propiedades
kind	string Identifica el tipo de recurso de la API. El valor será youtube#playlist.
etag	etag La Etag de este recurso.
id	string ID que YouTube utiliza para identificar de forma exclusiva la playlist.
snippet	object El objeto snippet contiene información básica sobre la playlist, como el título y la descripción.
snippet.publishedAt	datetime Fecha y hora en que se creó la playlist. El valor se especifica en el formato ISO 8601.
snippet.channelId	string ID que YouTube utiliza para identificar de forma exclusiva el canal que publicó la playlist.
snippet.title	string Título de la playlist.
snippet.description	string La descripción de la playlist
snippet.thumbnails	object Mapa de imágenes en miniatura asociadas con la playlist Para cada objeto en el mapa, la clave es el nombre de la imagen en miniatura, y el valor es un objeto que contiene información adicional sobre la viñeta.
snippet.thumbnails.(key)	object Los valores de clave válidos son los siguientes: default: es la 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: es una 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: Es una 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. standard: es una versión de la imagen en miniatura con una resolución aún mayor que la de la imagen con resolución high. Esta imagen está disponible para algunos videos y otros recursos que hacen referencia a videos, como elementos de listas de reproducción o resultados de búsqueda. Esta imagen es de 640 píxeles de ancho y 480 píxeles de alto. maxres: Es la versión con la resolución más alta de la imagen en miniatura. Este tamaño de imagen está disponible para algunos videos y otros recursos que hacen referencia a videos, como elementos de listas de reproducción o resultados de búsqueda. Esta imagen es de 1280 píxeles de ancho y 720 píxeles de alto.
snippet.thumbnails.(key).url	string La URL de la imagen.
snippet.thumbnails.(key).width	unsigned integer El ancho de la imagen.
snippet.thumbnails.(key).height	unsigned integer La altura de la imagen.
snippet.channelTitle	string Título del canal al que pertenece el video.
snippet.tags[]	list Esta propiedad dejó de estar disponible. Son las etiquetas de palabras clave asociadas con la playlist.
snippet.defaultLanguage	string El idioma del texto en las propiedades snippet.title y snippet.description del recurso playlist.
snippet.localized	object El objeto snippet.localized contiene un título y una descripción localizados de la playlist o el título en el idioma predeterminado de los metadatos de la playlist. El texto localizado se muestra en el fragmento de recurso si la solicitud playlists.list usó el parámetro hl para especificar un idioma en el que se debe mostrar el texto localizado y el texto localizado está disponible en ese idioma. Si no se especifica un valor del parámetro hl o se especifica un valor, pero los metadatos localizados no están disponibles para el idioma especificado, se muestran los metadatos del idioma predeterminado. La propiedad contiene un valor de solo lectura. Usa el objeto localizations para agregar, actualizar o borrar títulos localizados.
snippet.localized.title	string Es el título localizado de la playlist.
snippet.localized.description	string Es la descripción localizada de la playlist.
status	object El objeto status contiene información sobre el estado de la playlist.
status.privacyStatus	string El estado de privacidad de la playlist. Los valores válidos para esta propiedad son los siguientes: private public unlisted
contentDetails	object El objeto contentDetails contiene información sobre el contenido de una playlist, incluida la cantidad de videos en ella.
contentDetails.itemCount	unsigned integer La cantidad de videos de la playlist.
player	object El objeto player contiene información que puedes usar para reproducir la playlist en un reproductor incorporado.
player.embedHtml	string Una etiqueta <iframe> que incorpora un reproductor que reproducirá la playlist.
localizations	object El objeto localizations contiene traducciones de los metadatos de la playlist.
localizations.(key)	object El idioma del texto localizado asociado con el par clave-valor. El valor es una string que contiene un código de idioma BCP-47.
localizations.(key).title	string Es el título localizado de la playlist.
localizations.(key).description	string Es la descripción localizada de la playlist.