Video

El componente Video en Nappai actúa como un puente seguro y eficiente entre tu flujo de automatización y la plataforma de YouTube. Su propósito principal es facilitarte la gestión de tus activos audiovisuales: desde subir archivos binarios hasta canales privados hasta recuperar datos específicos de videos existentes (como títulos, estadísticas o miniaturas).

Al integrar este componente, no necesitas escribir código complejo ni gestionar llamadas HTTP manuales. Nappai se encarga de comunicarse con la API de YouTube Data v3 por ti, permitiendo que tus automatizaciones se centren en la lógica de negocio mientras YouTube maneja el almacenamiento y la distribución del contenido.

¿Cómo funciona?

Internamente, este componente utiliza la API de YouTube para realizar acciones específicas sobre videos. Dependiendo de la configuración que elijas (como subir un video o consultar uno existente), el componente:

1. Autentica la solicitud utilizando las credenciales de Google que hayas configurado en tu panel.
2. Procesa los datos de entrada (ya sea un archivo de video binario para subir, o un ID para buscar información).
3. Comunica con los servidores de YouTube.
4. Devuelve una respuesta estructurada. Si subes un video, te confirmará su éxito y ID. Si consultas un video, te devolverá una “foto” completa de sus metadatos, estadísticas y enlaces de miniatura.

Esto te permite tomar decisiones automáticas basadas en el estado de tus videos o automatizar la publicación de contenido multimedia en tus canales.

Conexión y Credenciales

Este componente requiere configurar previamente una credencial en el panel de Nappai para poder interactuar con el servicio externo de Google. Sin esta configuración, el componente no podrá comunicarse con YouTube.

1. Dirígete a la sección de Credenciales en tu panel de Nappai.
2. Crea una nueva credencial del tipo Youtube API.
3. En tu flujo de trabajo, selecciona la credencial guardada en el campo de entrada Credential de este nodo.

Nota: Asegúrate de tener los permisos necesarios en tu cuenta de Google Cloud (Client ID y Client Secret) para permitir que Nappai gestione tus videos.

Entradas

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones o modos de uso:

• Operation: Selecciona el tipo de acción que deseas realizar (ej. subir un video, obtener información, etc.).
• Old Region: Especifica la región geográfica original del video.
• Old Video ID: Utiliza este campo si necesitas referenciar un ID de video antiguo para alguna operación de actualización o migración.
• Title: El título que aparecerá en tu video de YouTube.
• Description: La descripción detallada que se mostrará debajo del video.
• Category: La categoría del video (ej. Educación, Entretenimiento, etc.). Nota: Esta opción depende de la Región seleccionada; asegúrate de definir la región primero.
• Language: El idioma principal del video (proporcionado por la lista de YouTube).
• Region: La región geográfica donde se publicará o categorizará el video.
• Binary: El archivo de video en formato binario (archivo .mp4, .avi, etc.) que deseas subir al canal.
• Privacy Status: Define quién puede ver el video.
  • Private: Solo tú puedes verlo.
  • Unlisted: Cualquiera con el enlace puede verlo, pero no aparece en búsquedas.
  • Public: Visible para todos y aparece en resultados de búsqueda.
• Tags: Etiquetas clave para ayudar a que tu video sea encontrado por los usuarios.
• Make For Kids: Indica si el video está dirigido a niños. Esto afecta a cómo se muestra y se monitorea según las normas de YouTube.
• Notify Subscribers: Si activas esta opción, los suscriptores recibirán una notificación sobre el nuevo video. (Solo funciona para videos Públicos).
• Mode: El modo de operación específico del video.
• Video ID: El identificador único o la URL del video del cual deseas obtener información o gestionar datos.
• Rating: El nivel de clasificación del video.
• Get Rating: Si estás consultando datos, selecciona qué tipo de clasificación deseas obtener.
• Max Results: El número máximo de resultados que deseas recibir si estás buscando o listando varios videos.

Salidas

El componente produce un resultado estructurado que puedes utilizar en pasos posteriores de tu automatización.

Ejemplo de Respuesta JSON

Cuando el componente se ejecuta correctamente, devuelve un objeto similar al siguiente. Esto te permite acceder a datos como el título, las estadísticas de vistas o los enlaces de las miniaturas en otros componentes del flujo. json { “video_id”: “dQw4w9WgXcQ”, “title”: “Ejemplo de Video de Prueba”, “privacy_status”: “public”, “statistics”: { “viewCount”: “10500”, “likeCount”: “340”, “commentCount”: “12” }, “thumbnail_url”: “https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg” }

Conectividad

Este componente suele conectarse como un nodo de acción en el medio o final de un flujo de trabajo.

• Entradas: Se conecta comúnmente a otros componentes que generan archivos (para la entrada Binary) o que extraen información de texto (para Title y Description).
• Salidas: Las salidas suelen conectarse a nodos de notificación (como Email o Slack) para informar sobre el éxito de una subida, o a nodos de base de datos para guardar las estadísticas de los videos. También puede alimentar nodos de análisis que consuman los datos de Statistics.

Ejemplo de Uso

Imagina que tienes un flujo de marketing que sube automáticamente videos promocionales a tu canal de YouTube.

1. Descargas un archivo de video desde una base de datos y lo almacenas temporalmente.
2. Utilizas el componente Video.
3. En el campo Binary, conectas la salida del archivo descargado.
4. En Title, escribes “Nueva Promoción de Verano”.
5. En Privacy Status, seleccionas “Unlisted” para que solo quienes tengan el enlace puedan verlo antes de la campaña oficial.
6. Al activar Notify Subscribers (si es posible según la configuración), tus fans recibirán una alerta.
7. El componente devuelve el Video ID, que luego puedes usar para generar un enlace corto y compartirlo en tu red social automatizada.

Consejos y Mejores Prácticas

• Revisa las Credenciales: Asegúrate de que las credenciales de Google Cloud tengan los permisos adecuados para “Gestionar tus videos” antes de intentar subir contenido.
• Idioma y Región: Define siempre la Language y Region correctamente para mejorar el alcance de tus videos en la región objetivo.
• Uso de Estadísticas: Si necesitas saber cuántas vistas tiene un video, usa la operación de consulta y mapea el campo statistics a tus siguientes pasos.
• Archivos Grandes: Ten en cuenta que la subida de videos grandes puede tardar más tiempo; ajusta los tiempos de espera en tu flujo si es necesario.

Consideraciones de Seguridad

• Privacidad: Ten mucho cuidado al seleccionar “Public” en Privacy Status. Asegúrate de que el contenido audiovisual sea adecuado y cumpla con las normas de la comunidad de YouTube para evitar penalizaciones en tu canal.
• Protección de Datos: No subas videos que contengan información sensible o personal (PII) si vas a marcar el video como “Public”.
• Credenciales: Mantén tus Client IDs y Client Secrets en el panel de credenciales de Nappai seguros y no los compartas en códigos visibles en otros nodos.