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. 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 listas de reproducción para identificar colecciones especiales de videos para 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 con un canal, que es una colección de videos, listas de reproducción y otra información de YouTube de una persona, un grupo o una 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 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 de playlists:

list
Muestra una colección de listas de reproducción 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 lista de reproducción. Pruébala ahora.
actualizar
Modifica una lista de reproducción. Por ejemplo, puede cambiar el título, la descripción o el estado de la privacidad. Pruébala ahora.
borrar
Borra una lista de reproducción. Pruébala ahora.

Representación de recursos

La siguiente estructura JSON 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 API. El valor será youtube#playlist.
etag etag
Es la Etag de este recurso.
id string
Indica el ID que usa YouTube para identificar de forma exclusiva la lista de reproducción.
snippet object
El objeto snippet contiene detalles básicos sobre la lista de reproducción, como el título y la descripción.
snippet.publishedAt datetime
La fecha y hora en que se creó la lista de reproducción. 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 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 información adicional sobre la viñeta.
snippet.thumbnails.(key) object
Estos son los valores clave válidos:
  • default: 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: 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.
  • standard: Versión de mayor resolución de la imagen en miniatura que la imagen de 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 de la resolución más alta de la imagen en miniatura. El tamaño de 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 1280 píxeles de ancho y 720 píxeles 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
Es la altura de la imagen.
snippet.channelTitle string
Corresponde al título del canal al que pertenece el video.
snippet.tags[] list
Esta propiedad dejó de estar disponible.

Etiquetas de palabras clave asociadas con la lista de reproducción.
snippet.defaultLanguage string
Es 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 lista de reproducción o el título en el idioma predeterminado de los metadatos de la lista de reproducción.
  • El texto localizado se muestra en el fragmento de recurso si la solicitud playlists.list usó el parámetro hl para especificar un idioma para el que se debe mostrar texto localizado y el texto localizado está disponible en ese idioma.
  • Se muestran los metadatos del idioma predeterminado 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.
La propiedad contiene un valor de solo lectura. Usa el objeto localizations para agregar, actualizar o borrar títulos localizados.
snippet.localized.title string
Título de la lista de reproducción localizada
snippet.localized.description string
Es la descripción localizada de la lista de reproducción.
status object
El objeto status contiene información de 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 los siguientes:
  • private
  • public
  • unlisted
contentDetails object
El objeto contentDetails contiene información sobre el contenido de una lista de reproducción, incluido el número de videos de esta.
contentDetails.itemCount unsigned integer
Indica la cantidad de videos de la lista de reproducción.
player object
El objeto player contiene información que usarías para reproducir la lista de reproducción en un reproductor incorporado.
player.embedHtml string
Es una etiqueta <iframe> que incorpora un reproductor que reproducirá la lista de reproducción.
localizations object
El objeto localizations encapsula las traducciones de los metadatos de la lista de reproducción.
localizations.(key) object
Indica el idioma del texto localizado asociado al valor clave. El valor es una string que contiene un código de idioma BCP-47.
localizations.(key).title string
Título de la lista de reproducción localizada
localizations.(key).description string
Es la descripción localizada de la lista de reproducción.