Playlist Item
Playlist Item conecta tu flujo con tu canal de YouTube para gestionar los vídeos que contiene una lista de reproducción: ver qué vídeos tiene, añadir un vídeo en la posición que quieras, moverlo de posición o quitarlo de la lista.
Cada vídeo dentro de una lista es un elemento con su propio identificador, distinto del identificador del vídeo. Ese identificador del elemento es el que se usa para moverlo o quitarlo.
Cuándo usarlo
- Añadir cada vídeo nuevo de un curso a su lista de reproducción en cuanto se publica.
- Poner el último vídeo publicado en la primera posición de la lista de novedades.
- Consultar qué vídeos tiene una lista para enviar el índice a los alumnos.
- Quitar de una lista los vídeos que ya no están vigentes.
Configuración
Necesitas una credencial Youtube API, que se conecta iniciando sesión con tu cuenta de Google. Al crearla tienes que indicar el Client ID y el Client Secret de un proyecto propio de Google Cloud. Consulta Credenciales.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial Youtube API con la que se accede a tu canal. |
| Operation | Lo que hace el componente. Ver Operaciones. Por defecto, Get Playlist Items. |
| Item ID | El identificador del elemento de la lista. Lo encuentras en el campo id del resultado de Get Playlist Items. Obligatorio en Delete Playlist Item y Update Playlist Item. En Get Playlist Items, trae solo ese elemento. No aparece en Create Playlist Item. |
| Playlist ID | El identificador o el enlace de la lista de reproducción. Obligatorio en Create Playlist Item. En Get Playlist Items, trae los vídeos de esa lista; indica este campo o Item ID. |
| Max Results | Solo en Get Playlist Items. Cuántos vídeos traer como máximo. Por defecto, 10. |
| Video ID | Solo en Create Playlist Item, donde es necesario. El identificador o el enlace del vídeo que quieres añadir. |
| Index | En Create Playlist Item y Update Playlist Item. La posición del vídeo en la lista, empezando por 0 para la primera. Por defecto, 0. |
Operaciones
| Operación | Qué hace |
|---|---|
Get Playlist Items | Trae los vídeos de una lista, o un elemento concreto a partir de su Item ID. |
Create Playlist Item | Añade un vídeo a la lista en la posición indicada en Index. |
Delete Playlist Item | Quita un vídeo de la lista. El vídeo no se borra de YouTube. |
Update Playlist Item | Mueve un vídeo a la posición indicada en Index. |
Resultado
La salida Result devuelve un elemento por cada vídeo de la lista con el que has trabajado: el identificador del elemento (id), el título y la descripción del vídeo, su imagen, el identificador del vídeo (video_id), el de la lista (playlist_id), su posición (position) y su privacidad. Delete Playlist Item devuelve una confirmación.
Puedes conectar el resultado a un componente de correo para enviar el índice de la lista, o a un agente. El componente también se puede conectar a un Agente como herramienta. Ver Tool Mode.
Ejemplo
Una academia añade cada clase nueva a la lista de su curso.
- Cuando se sube la clase, el flujo recibe el enlace del vídeo.
- Añade Playlist Item con la operación
Create Playlist Item. - Pega el enlace de la lista del curso en Playlist ID y el del vídeo en Video ID.
- En Index, indica el número de la clase menos uno para que quede en su sitio: la clase 1 en la posición 0, la clase 2 en la 1, y así sucesivamente.
Buenas prácticas
- Para mover o quitar un vídeo usa el Item ID, no el identificador del vídeo. Si no lo tienes, obtenlo antes con
Get Playlist Items. - Solo puedes cambiar las listas de reproducción de tu propio canal.