Personas: admins de empresa, admins de equipo
Plataformas: navegador, escritorio
La integración de Google Workspace permite a los usuarios insertar contenido de Google Docs, Sheets y Slides en los tableros de Miro. Esta guía cubre la implementación técnica de la integración, el modelo de seguridad y el manejo de datos para los admins que evalúan o configuran la integración.
Funciones principales
- Live Embed: Los usuarios pueden insertar contenido de Google Docs, Google Sheets o Google Slides en un tablero de Miro como un iframe en vivo.
- Seguro: A cada visitante del tablero se le solicita iniciar sesión en el iframe antes de poder ver el contenido insertado.
- Opciones de visualización: Los usuarios pueden elegir mostrar el contenido insertado como Live Embed o como marcador.
- Modo sin distracciones: Los usuarios pueden expandir un Live Embed o un marcador al modo sin distracciones para verlo sin distracciones.
- Atajo de acción: Los usuarios pueden agregar un atajo de acción que abre un cuadro de diálogo para insertar un enlace de Google Docs, Google Sheets o Google Slides.
- Selector de recursos: Los usuarios pueden agregar una diapositiva específica como imagen estática en el tablero, de modo que los colaboradores puedan ver y consultar ese contenido exacto sin necesitar acceso al archivo original.
- Controles de admin: Los admins pueden impedir que los usuarios usen el selector de recursos para agregar contenido de Google Slides como imágenes estáticas.
Limitaciones
- El selector de recursos está disponible solo para Google Slides. No está disponible para Google Docs ni para Google Sheets.
Implementación técnica
Miro se integra con Google Workspace a través de la API REST de Google. Los usuarios autorizan el acceso con OAuth 2.0 y luego vinculan sus archivos de Google Docs, Google Sheets o Google Slides a un tablero de Miro.
Consideraciones de seguridad
El selector de activos de la integración permite que los usuarios adjunten parte de un archivo de Google Slides al lienzo como una imagen estática. Solo los usuarios autorizados pueden acceder al Live Embed, pero cualquiera con acceso al tablero puede ver la imagen estática adjunta. En los tableros públicos, agregar activos desde inserciones está deshabilitado por defecto.
Los admins de la empresa pueden deshabilitar el selector de activos para todos los tableros:
- Ve a Configuración de la empresa > Aplicaciones e integraciones > Aplicaciones > Google Office Integration App (en la pestaña Administrar aplicaciones).
- Activa/desactiva Impedir que los usuarios agreguen activos desde inserciones al lienzo.
Flujos de datos
- Un usuario que forma parte de un equipo u organización con esta función habilitada pega un enlace de Google Docs, Sheets o Slides en un tablero de Miro.
- Miro lee el enlace. Si el usuario aún no ha autorizado la integración, Miro inicia el flujo de OAuth y redirige al usuario a la página de autorización de Google.
- Después de que el usuario concede la autorización, el servicio de integración de Miro utiliza el token de acceso del usuario para llamar a la API REST de Google y recuperar el contenido.
Qué datos de Google almacena Miro
Miro obtiene y almacena los siguientes datos de los enlaces de Google Workspace pegados:
- Títulos de documentos y archivos
- Imágenes creadas por el selector de activos
Retención de datos
Los datos incrustados siguen la política estándar de retención de datos de Miro para todos los datos del cliente.
Autenticación y autorización
Incrustar un vínculo de Google Docs, Google Sheets o Google Slides en un tablero requiere que el usuario autorice la integración mediante la pantalla de consentimiento OAuth de Google. Según la configuración de Google Workspace del cliente, esto también puede requerir que un admin de Google Workspace apruebe la integración.
Alcances de autorización requeridos
La integración de Google Workspace requiere los siguientes ámbitos:
https://www.googleapis.com/auth/presentations.readonly https://www.googleapis.com/auth/spreadsheets.readonly https://www.googleapis.com/auth/documents.readonly
Qué se almacena en Miro y cómo
Miro almacena dos categorías de datos para esta integración: datos de autorización y datos de previsualización.
- Datos de autorización: Miro almacena el token de acceso y el token de actualización en su base de datos durante varios días. Mientras la autorización esté activa, Miro renueva automáticamente un token de acceso vencido usando el token de actualización, sin requerir que el usuario vuelva a autorizar. Todos los datos almacenados para esta integración se cifran en reposo con AES de 256 bits.
- Datos de previsualización: Miro almacena dos tipos de datos de previsualización: las imágenes capturadas por el selector de activos (almacenadas como parte del tablero) y los títulos y referencias de imagen (almacenados cifrados en un servicio interno).
Revocar un token
Los usuarios pueden revocar el acceso de la integración en cualquier momento desde su cuenta de Google, siguiendo la guía de Google Identity.
Configurar la integración de Google Workspace
Nota: Solo los admin de equipo de Miro pueden instalar la aplicación. Si tu organización de Miro solo permite aplicaciones aprobadas y un usuario regular pega un enlace de Google Workspace, ese usuario verá en su lugar un cuadro de diálogo para solicitar la instalación de la aplicación.
Para instalar y comenzar a usar la integración:
- Copia la URL del archivo de documentos, hojas de cálculo o diapositivas de Google.
- Pega la URL en tu tablero de Miro.
-
Lo que ocurre a continuación depende de quién pegó el enlace:
- Un admin de equipo de Miro pega el enlace: La app se autoriza e instala automáticamente y el enlace se despliega sin más acciones.
- Un usuario normal pega el enlace y la organización solo permite aplicaciones aprobadas: Se abre un cuadro de diálogo para solicitar la instalación de la aplicación. Después de que el usuario solicita permiso, los admins de empresa pueden seguir el flujo de solicitud de apps para aprobar la solicitud.
Conectar una cuenta de Google
Después de que la integración esté instalada y autorizada:
- Haz clic en Conectar en el widget creado después de pegar la URL en el tablero. Se te redirige a una página de Google que te pide que otorgues a Miro acceso a tu cuenta.
- Confirma la autorización en Google. El contenido de Google se agrega a tu tablero como un iframe.
Preguntas frecuentes
¿Qué usuarios pueden insertar contenido de Google en Miro?
Tanto el usuario como el tablero de Miro deben cumplir los siguientes criterios:
- El usuario ha autorizado la integración de Miro con Google Workspace.
- El usuario tiene acceso al contenido de Google que intenta insertar.
¿Qué usuarios pueden ver el contenido de Google insertado?
Cualquiera que tenga acceso al tablero de Miro y permiso del propietario del contenido insertado — es decir, cualquiera con permiso para ver, comentar o editar en el tablero. Los visualizadores no necesitan autorizar la integración ni tener una licencia de Google para ver el contenido insertado en el tablero.
¿Tienen que volver a autorizarse los usuarios para pegar enlaces en otros tableros?
No, siempre que la autorización siga siendo válida (Miro considera válida una autorización durante un mes después de concederla). Los usuarios pueden pegar enlaces de Google Workspace en cualquier tablero y el contenido se importa con normalidad.
Si el tablero pertenece a un equipo u organización diferente donde esta integración no está habilitada, el usuario no podrá usarla allí.
¿Puedo acceder en Miro a contenido de Google al que no puedo acceder directamente en Google?
No. Solo puedes insertar contenido de Google al que ya tienes acceso —no puedes usar la integración para ver algo que no podrías abrir directamente en Google. Dicho esto, si alguien con acceso ya insertó el contenido como una imagen estática en un tablero que compartes con esa persona, puedes ver esa instantánea incluso sin tener acceso directo al archivo origen. La integración no aplica ninguna política de acceso adicional más allá de esto; usa la propia configuración de uso compartido del tablero de Miro para restringir quién puede colaborar. Ten en cuenta que una imagen estática no se puede usar para explorar los datos subyacentes, abrir el archivo original ni cambiar filtros.
¿Dónde puedo encontrar el Miro Data Processing Addendum?
Consulta el Anexo de Procesamiento de Datos de Miro.
¿Qué está prohibido en los tableros públicos de Miro?
Por razones de seguridad, los tableros públicos deshabilitan:
- Extracción de activos — admitida por las integraciones de Looker, Google Slides, Figma, Power BI, Microsoft Word, Microsoft Excel y Microsoft PowerPoint.
- Despliegue directo de activos (activo en lugar de Live Embed) — admitido por la integración de Figma.
¿Cómo puedo restringir el acceso al tablero a las mismas personas que tienen acceso al archivo de origen?
La integración solo controla el acceso a los archivos en el sistema de origen (Google), no en Miro. Por defecto, esto no se aplica — para mantener este nivel de seguridad, los admins de la organización de Miro deben deshabilitar el asset picker en la configuración de administración de la aplicación.
Deshabilitar el asset picker impide que el contenido de Google se guarde como imágenes estáticas en un tablero de Miro, donde más tarde podría ser visto por personas que no tienen acceso al archivo en Google (por ejemplo, si el tablero se comparte públicamente o con personas que no tienen acceso en el sistema de origen).