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 para la autorización

Te recomendamos que uses las siguientes prácticas recomendadas para todos los complementos de Google Meet que requieran autenticación o autorización.

Usa el Acceso con Google

Muchos usuarios de los 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 a los usuarios varios clics cuando realizan el flujo de acceso. Para obtener más información, consulta Administra los métodos de acceso de tu complemento.

Cómo abrir 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 y volver a la llamada de Meet, y realizará menos clics en general.

Solicita correctamente los permisos de 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 de configuración de apps de Google Workspace Marketplace. Después de agregar estos permisos, a los usuarios se les mostrará un mensaje cuando instalen tu complemento de Meet que les indicará a qué tipo de datos les 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 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 configurar la información de desarrollo de la marca, la política de privacidad y las condiciones del servicio que se muestran cuando se solicitan los permisos. Para publicar de forma pública, toda esta información se debe enviar para la verificación.

Cuando escribas código para llamar a las APIs de Google Workspace, la forma más fácil 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 token en JavaScript, es necesario solicitar por separado los alcances que la aplicación 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 del mercado de Google Workspace. Esta redundancia proporciona un resguardo para controlar el caso en el que un usuario revocó los permisos.

Prácticas recomendadas de mantenimiento

Las siguientes prácticas recomendadas son para escribir aplicaciones web que se pueden mantener, pero son particularmente importantes cuando escribes 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, haz lo siguiente:

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

Crea un proyecto de Google Cloud de pruebas

Una vez que tu complemento de Google Meet se publique en Google Workspace Marketplace, las implementaciones nuevas de tu complemento de Google Meet estarán disponibles de inmediato para los usuarios de Meet. Los usuarios verán estas actualizaciones en cuanto vacíen sus cachés o cuando venza la caché. Por lo tanto, te recomendamos que no publiques cambios en tu sitio de producción hasta que se prueben de forma exhaustiva.

Para evitar la implementación directamente en producción, recomendamos crear un proyecto de Google Cloud separado que se publique de forma privada en la organización. Este proyecto de Cloud alojará los entornos de etapa de pruebas y de 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 contengan tu complemento en un dominio que te pertenezca. Luego, puedes crear entornos alternativos para tu complemento de Meet agregando implementaciones adicionales a tu proyecto de Google Cloud de preparación. 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 complementos 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 Install en la columna Actions para instalar la versión de desarrollo del complemento de Meet solo en tu cuenta.

Cómo escribir pruebas

Antes de implementar tu complemento de Meet en un entorno de desarrollo, te recomendamos que escribas pruebas de unidades. Las pruebas de unidad deben incluir lo siguiente:

  • Emular el SDK de complementos de Meet y, luego, verificar que el complemento de Meet llame a las funciones del SDK como se espera
  • Realiza pruebas de unidades en todas las funciones de tu complemento que no pertenecen al SDK con tu framework de prueba web preferido.

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 según las acciones que realicen los usuarios en el panel lateral. Para ello, configura el estado de inicio de la actividad en JavaScript. El iniciador del complemento (por lo general, el anfitrión de la reunión) debe configurar todos los datos que se ingresan en ActivityStartingState en el 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 lo uses

Después de iniciar la actividad llamando al método startActivity(), solo debes mantener el panel lateral abierto si es una parte esencial de la experiencia del usuario para tu complemento de Google Meet. Para cerrar el panel lateral una vez que esté abierto el escenario principal, llama 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 enriquecedora que 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 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 y 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 de logotipos

Cuando diseñes tu logotipo específico de Meet, sigue estos lineamientos para que se vea mejor ahora y en el futuro:

Usa el formato de archivo PNG con un tamaño de 256 px x 256 px.

Usa transparencia.

Verifica que el logotipo en modo oscuro se vea bien en ese modo con las herramientas para desarrolladores de complementos de Meet.

Cumple con los requisitos de gráficos para integraciones de apps específicas.

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