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)
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:
|
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.
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:
|
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. |