Prácticas recomendadas

Sigue estas guías para el diseño de complementos de Google Meet y mejora la experiencia general de los usuarios.

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 los usuarios cuando realizan el flujo de acceso. Para obtener más información, consulta Administra los métodos de acceso para 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 realizará menos clics en general.

Solicita correctamente los alcances para las APIs de Google

Si tu complemento de Meet llama a las APIs de Google, entonces debes proporcionar una lista completa de los alcances de OAuth que requiere tu complemento. Esto se hace en la página Configuración de la app de Google Workspace Marketplace. Después de agregar estos alcances, se muestra un mensaje a los usuarios cuando instalan tu complemento de Meet que les indica 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. Para ello, debes agregar exactamente los mismos alcances de autorización desde 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 los alcances. Para publicar de forma pública, se debe enviar toda esta información para su verificación.

Cuando escribas código para llamar a las APIs de Google Workspace, la forma más sencilla de comenzar es seguir la Guía de inicio rápido de JavaScript. Este enfoque cumple con las prácticas recomendadas para usar el Acceso con Google y las ventanas de diálogo. Ten en cuenta que, para inicializar el cliente de tokens en JavaScript, es necesario solicitar por separado los alcances que la aplicación usa en tiempo de ejecución. Para obtener la mejor experiencia del usuario, estos alcances solicitados deben coincidir con los de la página Configuración de la app de Google Workspace Marketplace. Esta redundancia proporciona una solución alternativa para controlar el caso en el que un usuario revocó los alcances.

Prácticas recomendadas de 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 versionado semántico. Para encontrar la versión más reciente, haz lo siguiente:

  • Cuando usas gstatic: La versión más reciente del SDK se encuentra en la URL de gstatic que se encuentra en las instrucciones para usar el SDK.
  • Cuando usas npm: Ejecuta npm update @googleworkspace/meet-add-ons desde el directorio que contiene el archivo package.json del sitio web que aloja tu complemento de Meet.

Crea un proyecto de Google Cloud de etapa de pruebas

Una vez que se publica tu complemento de Google Meet en el 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 venza la caché. Por lo tanto, te recomendamos que no envíes los cambios a tu sitio de producción hasta que se prueben por completo.

Para evitar la implementación directa en la producción, te recomendamos que crees un proyecto de Google Cloud independiente que se publique de forma privada en tu organización. Este proyecto de Cloud alojará los entornos de etapa de pruebas y desarrollo 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 contenga 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 ayudarte 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 unitarias deben incluir lo siguiente:

  • Simulación del SDK de complementos de Meet y, luego, verificación de que el complemento de Meet llame a las funciones del SDK según lo previsto.
  • Prueba de unidades de todas las funciones no relacionadas con el SDK de tu complemento con el framework de pruebas web que prefieras.

Prácticas recomendadas de 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 que se realizan en el panel lateral. Para ello, debes configurar el estado inicial de la actividad en JavaScript. El iniciador del complemento (por lo general, el organizador de la reunión) debe establecer todos los datos que ingresan en el ActivityStartingState dentro del panel lateral. 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 esté en uso

Después de iniciar la actividad llamando al startActivity() método, solo debes mantener abierto el panel lateral si es una parte esencial de la experiencia del usuario para tu complemento de Google Meet. Puedes cerrar el panel lateral una vez que se abra la etapa principal llamando al unloadSidePanel() método.

Promociona tu complemento de Meet a través del uso compartido de pantalla

Los complementos de Meet ofrecen una experiencia más completa que el uso compartido de pantalla. Sin embargo, muchos usuarios están acostumbrados a usar la función de uso compartido de pantalla de Meet. Si un usuario comparte una pestaña que muestra el sitio web que aloja tu complemento de Meet, se puede configurar Meet para que muestre 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 x 256 px.

Usa transparencia.

Verifica que tu logotipo en modo oscuro se vea bien en ese modo con las herramientas para desarrolladores de 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 gráficos para integraciones de apps específicas.

No incluyas relleno en la imagen. En su lugar, extiende la imagen a los límites del archivo.