Sigue estas guías para mejorar la experiencia general de los usuarios con el diseño de complementos de Google Meet.
Prácticas recomendadas de autorización
Te recomendamos que uses las siguientes prácticas recomendadas para cualquier complemento de Google Meet que requiera autenticación o autorización.
Usa el Acceso con Google
Muchos usuarios de complementos de Google Workspace ya habrán accedido a Google antes de unirse a la reunión. Por lo tanto, tener Google One Tap disponible como opción puede ahorrarles varios clics a tus usuarios cuando realicen el flujo de acceso. Para obtener más información, consulta Administra los métodos de acceso de tu complemento.
Abre la página de acceso de terceros en una ventana nueva
Además del acceso con Google, tu aplicación puede ofrecer mecanismos de acceso adicionales. Si es así, usa una ventana de diálogo en lugar de abrir una página de acceso en una pestaña nueva. De esta manera, el usuario podrá ver la llamada de Meet y volver a ella, y hará menos clics en general.
Solicita correctamente los permisos para las APIs de Google
Si tu complemento de Meet llama a las APIs de Google, debes proporcionar una lista completa de los alcances de OAuth que requiere tu complemento. Esto se hace en la página de configuración de la app de Google Workspace Marketplace. Después de agregar estos alcances, se les mostrará a los usuarios un mensaje cuando instalen tu complemento de Meet que les indicará a qué tipo de datos le permiten acceder a tu app.
Antes de publicar tu complemento, también debes configurar la pantalla de consentimiento de OAuth. Esto requiere agregar exactamente los mismos permisos de autorización de la configuración de la app de Google Workspace Marketplace. La configuración de la pantalla de consentimiento de OAuth también requiere establecer la información de la marca, la política de privacidad y las condiciones del servicio que se muestran cuando se solicitan permisos. Para publicar la información de forma pública, se debe enviar para su verificación.
Cuando escribas código para llamar a las APIs de Google Workspace, seguir la Guía de inicio rápido de JavaScript es la forma más sencilla de comenzar. Este enfoque cumple con las prácticas recomendadas para usar el acceso con Google y las ventanas de diálogo. Ten en cuenta que inicializar el cliente de tokens en JavaScript requiere solicitar por separado los permisos que la aplicación realmente usa en el tiempo de ejecución. Para brindar la mejor experiencia del usuario, estos permisos solicitados deben coincidir con los de la página Configuración de la app de Google Workspace Marketplace. Esta redundancia proporciona una alternativa para controlar el caso en el que un usuario revocó permisos.
Prácticas recomendadas para el mantenimiento
Las siguientes prácticas recomendadas son para escribir aplicaciones web que se puedan mantener, pero son especialmente importantes cuando se escriben complementos de Meet.
Usa la versión más reciente del SDK de complementos de Google Meet
El SDK de complementos de Meet se actualiza con regularidad. El SDK cumple con el control de versiones semántico. Para encontrar la versión más reciente, sigue estos pasos:
- Cuando se usa gstatic: La versión más reciente del SDK se encuentra dentro de la URL de gstatic que se encuentra en las instrucciones para usar el SDK.
- Cuando uses npm: Ejecuta
npm update @googleworkspace/meet-add-onsdesde el directorio que contiene elpackage.jsondel sitio web que aloja tu complemento de Meet.
Crea un proyecto de Google Cloud de etapa de pruebas
Una vez que tu complemento de Google Meet se publique en Google Workspace Marketplace, cualquier implementación nueva de tu complemento de Google Meet estará disponible de inmediato para los usuarios de Meet. Los usuarios verán estas actualizaciones en cuanto vacíen sus cachés o cuando estas venzan. Por lo tanto, te recomendamos que no envíes los cambios a tu sitio de producción hasta que se hayan probado de forma exhaustiva.
Para evitar la implementación directa en producción, te recomendamos crear un proyecto de Google Cloud independiente que se publique de forma privada para tu organización. En este proyecto de Cloud, se alojarán los entornos de desarrollo y de etapa de pruebas de tu complemento de Meet. El acceso a este proyecto de Cloud debe limitarse a un equipo más pequeño que trabaje directamente en el desarrollo de tu complemento.
Para crear estos entornos alternativos para tu complemento, primero debes alojar entornos alternativos de tu aplicación web que contiene tu complemento en un dominio de tu propiedad. Luego, puedes crear entornos alternativos para tu complemento de Meet agregando implementaciones adicionales a tu proyecto de Google Cloud de etapa de pruebas. Estas implementaciones nuevas deben tener manifiestos que apunten a los entornos alternativos de tu aplicación web. Luego, te recomendamos que instales cada entorno de complemento de la siguiente manera:
- Etapa de pruebas: Publica la versión de etapa de pruebas de forma privada para que cualquier persona de tu organización pueda ayudar con las pruebas.
- Desarrollo: Haz clic en Instalar en la columna Acciones para instalar la versión de desarrollo del complemento de Meet solo en tu cuenta.
Escribe pruebas
Antes de implementar tu complemento de Meet en un entorno de desarrollo, te recomendamos que escribas pruebas unitarias. Tus pruebas de unidad deben incluir lo siguiente:
- Simular el SDK de complementos de Meet y, luego, verificar que el complemento de Meet llame a las funciones del SDK según lo esperado
- Realiza pruebas de unidades de toda la funcionalidad de tu complemento que no esté relacionada con el SDK con tu framework de pruebas web preferido.
Prácticas recomendadas para la experiencia del usuario
Las siguientes prácticas recomendadas ayudan a que un complemento de Meet sea más intuitivo y refinado.
Administra todo el estado inicial en el panel lateral
Te recomendamos que configures tu complemento en función de las acciones del usuario en el panel lateral.
Esto se hace configurando el estado inicial de la actividad en JavaScript. Todos los datos que se ingresan en ActivityStartingState deben establecerse en el panel lateral por el iniciador del complemento (por lo general, el organizador de la reunión). Puedes considerar la primera vista del panel lateral como un formulario que controla la configuración de tu complemento.
Cierra el panel lateral cuando no lo uses
Después de iniciar la actividad llamando al método startActivity(), solo debes mantener abierto el panel lateral si es una parte esencial de la experiencia del usuario de tu complemento de Google Meet. Puedes cerrar el panel lateral una vez que se abra el escenario principal llamando al método unloadSidePanel().
Promociona tu complemento de Meet a través del uso compartido de pantalla
Los complementos de Meet ofrecen una experiencia más enriquecida que la función de compartir pantalla. Sin embargo, muchos usuarios están acostumbrados a usar la función de compartir pantalla de Meet. Si un usuario comparte una pestaña en la que se muestra el sitio web que aloja tu complemento de Meet, Meet se puede configurar para mostrar un banner a todos los participantes de la llamada en el que se les solicite que instalen o usen el complemento de Meet correspondiente. Para obtener más información, consulta cómo promocionar tu complemento a través del uso compartido de pantalla.
Lineamientos de diseño del logotipo
Sigue estos lineamientos cuando diseñes tu logotipo específico de Meet para que se vea lo mejor posible ahora y en el futuro:
Usa el formato de archivo PNG, con un tamaño de 256 px x 256 px.
Usa la transparencia.
Verifica que el logotipo del modo oscuro se vea bien en ese modo con las herramientas para desarrolladores de los complementos de Meet.
Verifica que tu logotipo (y otros recursos gráficos) se vean bien en el modo de contraste alto con un verificador de contraste, como Contrast Checker de Web Accessibility In Mind (WebAIM).
Cumple con los requisitos de gráficos para las integraciones de apps específicas.
No incluyas relleno en la imagen. En su lugar, extiende la imagen hasta los límites del archivo.