Los complementos de Google Workspace deben ser coherentes con las el estilo y la disposición del aplicación host se extienden. Debería extender la IU naturalmente mediante el uso de controles y comportamientos conocidos. Las pautas presentadas describiremos cómo manejar el texto, las imágenes, los controles y el desarrollo de la marca que promueven una experiencia del usuario de alta calidad.
Si tu complemento abre páginas web separadas que son una parte integral del complemento (como una página de configuración del complemento), asegúrese de que esas páginas web también sigan estos lineamientos de estilo.
Imágenes y texto
En esta sección, se explica cómo usar correctamente el texto y las imágenes en tu complemento.
Nombre del complemento
Debes establecer el nombre de tu complemento en su proyecto manifiesto y cuando configura tu complemento para su publicación. El nombre aparece en muchos lugares, como Google Workspace Marketplace y dentro de los menús. Cuando elijas un nombre, ten en cuenta lo siguiente:
- Usa mayúsculas de título.
- Evita la puntuación, en especial los paréntesis, a menos que sean parte de tu marca.
- Sé breve (lo mejor es tener 15 caracteres o menos). Los nombres largos pueden ser truncarse automáticamente en la ficha de Google Workspace Marketplace y en otros lugares.
- No incluyas las palabras “Google”, “Gmail” ni otros nombres de productos de Google en el nombre de tu complemento.
- No incluyas la palabra “complemento”. en el nombre de tu complemento.
- Omite la información de la versión.
Estilo de escritura
No debería ser necesario escribir mucho. La mayoría de las acciones deben quedar claras iconografía, diseño y etiquetas cortas. Si encuentras una parte de tu complemento necesita una explicación más amplia de lo que pueden proporcionar las etiquetas cortas, práctica crear una página web separada que describa tu complemento y que incluya un enlace a él.
Cuando escribas texto de IU, ten en cuenta lo siguiente:
- Usa mayúscula inicial (especialmente para botones, etiquetas y acciones de tarjetas).
- Prefiere textos breves y simples sin jerga ni acrónimos.
Acciones universales y de tarjetas
Si usas acciones universales o las acciones de tarjeta en tus complemento, aparecen como elementos de menú en las tarjetas que definas. Puedes elegir el texto que se usará en estos menús para estas acciones. Cuando elijas el texto que usarás, ten en cuenta lo siguiente:
- Evita usar texto de menú que simplemente repita el nombre de tu complemento.
- Inicia cada elemento del menú con una palabra de acción, como “Ejecutar”, “Configurar” o “Crear”.
- Describe la tarea, no el componente de la IU que muestra la acción.
- Si tu acción inicia un flujo de trabajo y no hay un solo verbo que describa lo que hace, llámalo "Inicio".
- Mantén una cantidad pequeña de elementos de menú para evitar obligar al usuario a desplazarse. en una lista extensa. Si tienes que implementar más acciones, considera usar varias tarjetas con diferentes acciones en cada una.
Mensajes de error
Cuando algo sale mal, es importante usar un lenguaje sencillo. Explica problema desde el punto de vista del usuario y sugerir cómo solucionarlo.
- No permitas que el usuario vea ninguna excepción que arroje tu código. En cambio,
usa sentencias
try...catchpara interceptar excepciones y, luego, mostrar un mensaje de error fácil de usar. - Antes de publicar, verifica que tu complemento no muestre información de depuración. en la IU.
Contenido de ayuda
Es posible que desees diseñar tarjetas que muestren información de ayuda o expliquen la del complemento al usuario. Si creas contenido de ayuda para tus adicional, recuerda lo siguiente:
- Cuando sea posible, muestra las instrucciones en una lista numerada o con viñetas. Guía a los usuarios hasta el resultado final, con referencias claras a los elementos de la IU con nombre.
- Asegúrate de que tus instrucciones expliquen claramente los requisitos, como la configuración una hoja de cálculo de cierta manera.
- No dudes en incluir vínculos a contenido de ayuda externo, como páginas web de apoyo.
Imágenes
Las imágenes que se usan en el complemento son una de las tipos de íconos integrados o una imagen alojada de forma pública especificada por una URL. Cuando se usan imágenes alojadas asegúrate de que todas las personas que usen tu complemento puedan acceder a ellas.
Controles
Esta sección proporciona lineamientos sobre la experiencia del usuario para widgets interactivos.
Botones
Usa botones para controlar las acciones principales de tu interfaz de usuario en lugar de otros widgets.
- La mayoría de las etiquetas de botones de texto deben comenzar con un verbo.
- En la mayoría de los casos, las filas de botones deben tener un límite de tres o menos botones.
DecoratedText
Widgets DecoratedText te permiten presentar contenido de texto con íconos, botones o interruptores.
- Usa mayúscula inicial para el contenido del texto.
- El texto del widget DecoratedText se trunca si no cabe en la espacio disponible. Por este motivo, siempre trata de que el contenido del texto lo más breve posible.
Entradas de selección
Puedes utilizar una variedad de widgets de entrada de selección en tu complemento: cuadros de selección desplegables, casillas de verificación y botones de selección.
- Usa casillas de verificación cuando las personas puedan seleccionar varias opciones o ninguna opción. Usa botones de selección (o un menú de selección) cuando solo debas seleccionar una opción. Usa menús desplegables cuando proporciones una breve lista de alternativas mientras intentas y ahorrar espacio en la IU.
- Usa mayúscula inicial para el texto que se asigne a cada opción.
- Evita usar cambios de selección para activar acciones importantes y difíciles de revertir. porque las personas a menudo cometen errores al hacer selecciones. En cambio, considera agregar un botón que lea los valores de la selección actual y, luego, se active la acción.
- Para los menús desplegables, ordena las opciones alfabéticamente o según un esquema lógico. que todos los usuarios puedan comprender (como presentar los días de la semana en orden, a partir del domingo o el lunes).
- Restringe la cantidad de opciones en una entrada de selección determinada widget a una cantidad razonable. Si hay demasiadas opciones, es posible que los usuarios encuentren dificultar el uso del widget. En esos casos, considera dejar de lado la opción. en diferentes categorías y varios widgets.
Entradas de texto
Las entradas de texto proporcionan un lugar para que los usuarios ingresen datos de cadena.
- No uses una entrada de texto para que el usuario escriba uno de un conjunto específico de entradas posibles. En su lugar, usa un menú desplegable de selección.
- Usa pistas y sugerencias para ayudar al usuario a ingresar texto con la el formato y el contenido de una organización.
- Usa entradas de texto de varias líneas si el texto que se debe ingresar es muy grande. palabras.
Desarrollo de la marca
En esta sección, se proporcionan lineamientos sobre la experiencia del usuario para agregar elementos de marca. a la interfaz de tu complemento.
En tu complemento
Si deseas incluir la marca en la IU de tu complemento, sé breve y sencillo. Esto ayuda a los usuarios a enfocarse en la funcionalidad del complemento.
- Todos los aspectos de tu complemento deben cumplir con las lineamientos de desarrollo de la marca.
- No incluyas la palabra “Google”, “Gmail” ni otros nombres de productos de Google.
- No incluyas íconos de productos de Google, incluso si están alterados.
- No incluyas la palabra “complemento”. en el texto de desarrollo de la marca.
- El texto de la marca no debe tener más de unas pocas palabras.
En Google Workspace Marketplace
Cuando configuras el complemento para su publicación, proporcionas una serie de recursos gráficos y de texto para crear Ficha de Google Workspace Marketplace.
Todos los aspectos de la ficha de Play Store y estos recursos deben cumplir con las lineamientos de desarrollo de la marca.