Un recurso playlistItem
identifica otro recurso, como un video, que se incluye en una playlist. Además, el recurso playlistItem
contiene detalles sobre el recurso incluido que se relacionan específicamente con la forma en que se usa en esa playlist.
YouTube también usa una playlist para identificar la lista de videos subidos de un canal, y cada playlistItem
de esa lista representa un video subido. Puedes recuperar el ID de la playlist de esa lista desde el recurso channel
de un canal determinado. Luego, puedes usar el método playlistItems.list
en la lista.
Métodos
La API admite los siguientes métodos para los recursos playlistItems
:
- list
- Devuelve una colección de elementos de playlist que coinciden con los parámetros de solicitud de la API. Puedes recuperar todos los elementos de una lista de reproducción en una lista de reproducción específica o recuperar uno o más elementos de una lista de reproducción mediante sus ID únicos. Pruébala ahora.
- insertar
- Agrega un recurso a una playlist. Pruébala ahora.
- actualización
- Modifica un elemento de una playlist. Por ejemplo, puedes actualizar la posición del elemento en la lista de reproducción. Pruébala ahora.
- borrar
- Borra un elemento de una playlist. Pruébala ahora.
Representación de recursos
En la siguiente estructura JSON, se muestra el formato de un recurso playlistItems
:
{ "kind": "youtube#playlistItem", "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, "videoOwnerChannelTitle": string, "videoOwnerChannelId": string, "playlistId": string, "position": unsigned integer, "resourceId": { "kind": string, "videoId": string, } }, "contentDetails": { "videoId": string, "startAt": string, "endAt": string, "note": string, "videoPublishedAt": datetime }, "status": { "privacyStatus": 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#playlistItem . |
etag |
etag Es la etiqueta de Etag de este recurso. |
id |
string Es el ID que YouTube usa para identificar de forma exclusiva el elemento de la playlist. |
snippet |
object El objeto snippet contiene detalles básicos sobre el elemento de la playlist, como su título y posición en la playlist. |
snippet.publishedAt |
datetime Es la fecha y la hora en que se agregó el elemento a la playlist. El valor se especifica en formato ISO 8601. |
snippet.channelId |
string Es el ID que YouTube usa para identificar de forma única al usuario que agregó el elemento a la playlist. |
snippet.title |
string Es el título del elemento. |
snippet.description |
string Es la descripción del artículo. |
snippet.thumbnails |
object Es un mapa de imágenes de miniaturas asociadas con el elemento de 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:
|
snippet.thumbnails.(key).url |
string Es la URL de la imagen. |
snippet.thumbnails.(key).width |
unsigned integer Es el ancho de la imagen. |
snippet.thumbnails.(key).height |
unsigned integer Es la altura de la imagen. |
snippet.channelTitle |
string Es el título del canal al que pertenece el elemento de la playlist. |
snippet.videoOwnerChannelTitle |
string Es el título del canal que subió este video. |
snippet.videoOwnerChannelId |
string Es el ID del canal que subió este video. |
snippet.playlistId |
string Es el ID que YouTube usa para identificar de forma exclusiva la playlist en la que se encuentra el elemento. |
snippet.position |
unsigned integer Es el orden en el que aparece el elemento en la playlist. El valor usa un índice basado en cero, por lo que el primer elemento tiene una posición de 0 , el segundo elemento tiene una posición de 1 , y así sucesivamente. |
snippet.resourceId |
object El objeto id contiene información que se puede usar para identificar de forma única el recurso que se incluye en la playlist como el elemento de la playlist. |
snippet.resourceId.kind |
string Es el tipo de recurso al que se hace referencia. |
snippet.resourceId.videoId |
string Si el valor de la propiedad snippet.resourceId.kind es youtube#video , esta propiedad estará presente y su valor contendrá el ID que YouTube usa para identificar de forma única el video en la playlist. |
contentDetails |
object El objeto contentDetails se incluye en el recurso si el elemento incluido es un video de YouTube. El objeto contiene información adicional sobre el video. |
contentDetails.videoId |
string Es el ID que YouTube usa para identificar de forma exclusiva un video. Para recuperar el recurso video , establece el parámetro de consulta id en este valor en tu solicitud a la API. |
contentDetails.startAt |
string Nota: Esta propiedad dejó de estar disponible y, si se establece, se ignora su valor. Es la hora, medida en segundos desde el inicio del video, en la que este debe comenzar a reproducirse. (El propietario de la lista de reproducción puede especificar los tiempos en que el video debe empezar y detenerse cuando el video se reproduce en el contexto de la lista de reproducción). El valor predeterminado es 0 . |
contentDetails.endAt |
string Nota: Esta propiedad dejó de estar disponible y, si se establece, se ignora su valor. Es la hora, medida en segundos desde el inicio del video, en la que este debe dejar de reproducirse. (El propietario de la lista de reproducción puede especificar los tiempos en que el video debe empezar y detenerse cuando el video se reproduce en el contexto de la lista de reproducción). De forma predeterminada, se supone que video.endTime es el final del video. |
contentDetails.note |
string Es una nota generada por el usuario para este elemento. El valor de la propiedad tiene una longitud máxima de 280 caracteres. |
contentDetails.videoPublishedAt |
datetime Es la fecha y hora en que se publicó el video en YouTube. El valor se especifica en formato ISO 8601. |
status |
object El objeto status contiene información sobre el estado de privacidad del elemento de la playlist. |
status.privacyStatus |
string Es el estado de privacidad del elemento de la playlist. El canal que subió el video que representa el elemento de la playlist puede establecer este valor con el método videos.insert o videos.update . |