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 de un canal, como las siguientes:

  • 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 videos, playlists y otra información de YouTube de una persona, un grupo o una empresa. Puedes recuperar los IDs de las playlists de 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
Devuelve una colección de playlists que coinciden con los parámetros de la 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,
    "podcastStatus": enum
  },
  "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
Es el ETag de este recurso.
id string
Es el ID que YouTube usa para identificar de forma única la playlist.
snippet object
El objeto snippet contiene detalles básicos 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 formato ISO 8601.
snippet.channelId string
Es el ID que YouTube usa para identificar de forma única el canal que publicó la playlist.
snippet.title string
Es el título de la playlist.
snippet.description string
Es la descripción de la playlist.
snippet.thumbnails object
Es un 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 otra información 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 más alta 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 los elementos de playlists o los resultados de la búsqueda. Esta imagen tiene 640 px de ancho y 480 px 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 playlists o resultados de búsqueda. Esta imagen tiene 1,280 px de ancho y 720 px de alto.
snippet.thumbnails.(key).url string
Es la 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
Es el 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
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 para la playlist, o bien el título en el idioma predeterminado para los metadatos de la playlist.
  • El texto localizado se muestra en el resumen del recurso si la solicitud playlists.list usó el parámetro hl para especificar un idioma para el que se debe mostrar texto localizado y hay texto localizado disponible en ese idioma.
  • Los metadatos del idioma predeterminado se muestran si no se especifica un valor del parámetro hl o si se especifica un valor, pero no hay metadatos localizados disponibles para el idioma especificado.
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 de estado de la playlist.
status.privacyStatus string
Es el estado de privacidad de la playlist.

Los valores válidos para esta propiedad son los siguientes:
  • private
  • public
  • unlisted
status.podcastStatus string
Es el estado de podcast de la playlist. Si el valor es enabled, la playlist se marca como programa de podcast. Para establecer el estado de podcast de una playlist en enabled, esta debe tener una imagen de playlist.

Los valores válidos para esta propiedad son los siguientes:
  • enabled
  • disabled
  • unspecified
contentDetails object
El objeto contentDetails contiene información sobre el contenido de la playlist, incluida la cantidad de videos que contiene.
contentDetails.itemCount unsigned integer
Es la cantidad de videos en la playlist.
player object
El objeto player contiene información que usarías para reproducir la playlist en un reproductor integrado.
player.embedHtml string
Una etiqueta <iframe> que incorpora un reproductor que reproducirá la playlist.
localizations object
El objeto localizations encapsula las traducciones de los metadatos de la playlist.
localizations.(key) object
Es el idioma del texto localizado asociado con el valor de la clave. El valor es una cadena 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.