Los complementos de Google Workspace deben ser coherentes con el estilo y el diseño de la aplicación host que extienden. Deben extender la IU de forma natural con controles y comportamientos familiares. En los lineamientos que se presentan aquí, se describen formas de manejar texto, imágenes, controles y desarrollo de la marca que promueven una experiencia del usuario de alta calidad.
Si tu complemento abre páginas web independientes que son una parte integral de su funcionamiento (como una página de configuración), asegúrate de que esas páginas web también sigan estos lineamientos de estilo.
Texto e imágenes
En esta sección, se explica cómo usar texto e imágenes en tu complemento.
Nombre del complemento
Debes establecer el nombre del complemento en su manifiesto del proyecto y cuando lo configures para su publicación. El nombre aparece en muchos lugares, como en la ficha de Google Workspace Marketplace y en los menús. Cuando elijas un nombre, ten en cuenta lo siguiente:
- Usa mayúscula inicial.
- Evita la puntuación, en especial los paréntesis, a menos que sea parte de tu marca.
- El nombre debe ser corto (lo ideal es que tenga 15 caracteres o menos). Es posible que los nombres largos se trunquen 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 del complemento.
- No incluyas la palabra "complemento" en el nombre del complemento.
- No incluyas información sobre la versión.
Estilo de escritura
No deberías tener que escribir mucho. La mayoría de las acciones deben quedar claras a través de la iconografía, el diseño y las etiquetas cortas. Si descubres que una parte de tu complemento necesita una explicación más extensa que la que pueden proporcionar las etiquetas cortas, te recomendamos que crees una página web independiente que describa tu complemento y que incluyas un vínculo a ella.
Cuando escribas texto de la IU, ten en cuenta lo siguiente:
- Usa mayúscula inicial (en especial para los botones, las etiquetas y las acciones de la tarjeta).
- Prefiere el texto corto y claro sin jerga ni acrónimos.
Acciones universales y de la tarjeta
Si usas acciones universales o acciones de la tarjeta en tu complemento, aparecerán como elementos de menú en las tarjetas que definas. Puedes elegir el texto que se usa en estos menús para estas acciones. Cuando elijas el texto que se usará, ten en cuenta lo siguiente:
- Evita el texto del menú que repita el nombre del complemento.
- Comienza 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ámala "Iniciar".
- Mantén la cantidad de elementos del menú pequeña para evitar que el usuario tenga que desplazarse por una lista larga. Si tienes más acciones para implementar, considera usar varias tarjetas con diferentes acciones en cada una.
Mensajes de error
Cuando algo sale mal, es importante usar un lenguaje sencillo. Explica el problema desde el punto de vista del usuario y sugiere cómo solucionarlo.
- No permitas que el usuario vea ninguna excepción que arroje tu código. En su lugar, usa instrucciones
try...catchpara interceptar excepciones y, luego, muestra 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 quieras o necesites diseñar tarjetas que muestren información de ayuda o expliquen el funcionamiento del complemento al usuario. Si creas contenido de ayuda para tu complemento, 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 las instrucciones expliquen claramente los requisitos, como configurar una hoja de cálculo de una manera determinada.
- Puedes incluir vínculos a contenido de ayuda externo, como páginas web de asistencia.
Imágenes
Las imágenes que se usan en tu complemento son uno de los tipos de íconos integrados o una imagen alojada públicamente especificada por una URL. Cuando uses imágenes alojadas, asegúrate de que todos los usuarios que puedan usar tu complemento puedan acceder a ellas.
Controles
En esta sección, se proporcionan lineamientos de la experiencia del usuario para interactivos widgets.
Botones
Usa botones para controlar las acciones principales de la interfaz de usuario en lugar de otros widgets.
- La mayoría de las etiquetas de los botones de texto deben comenzar con un verbo.
- En la mayoría de los casos, las filas de botones deben limitarse a tres botones o menos.
DecoratedText
Los widgets DecoratedText te permiten presentar contenido de texto con íconos, botones o interruptores.
- Usa mayúscula inicial para el contenido de texto.
- El texto de un widget DecoratedText se trunca si no cabe en el espacio disponible. Por este motivo, siempre intenta que el contenido de texto sea lo más corto posible.
Entradas de selección
Puedes usar 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. Usa botones de selección (o un menú de selección) cuando se deba seleccionar exactamente una opción. Usa menús desplegables cuando proporciones una lista corta de alternativas mientras intentas ahorrar espacio en la IU.
- Usa mayúscula inicial para el texto que se asigna a cada opción.
- Evita usar cambios de selección para activar acciones importantes y difíciles de revertir, ya que las personas suelen cometer errores cuando realizan selecciones. En su lugar, considera agregar un botón que lea los valores de selección actuales y, luego, 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, comenzando por el domingo o el lunes).
- Restringe la cantidad de opciones en un widget de entrada de selección determinado a un número razonable. Si hay demasiadas opciones, es posible que los usuarios tengan dificultades para usar el widget. En esos casos, considera dividir 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 una de un conjunto específico de entradas posibles. En su lugar, usa una selección desplegable.
- Usa sugerencias y sugerencias para ayudar al usuario a ingresar texto con el formato y el contenido correctos.
- Usa entradas de texto multilínea si el texto que se ingresará tiene más de unas pocas palabras.
Desarrollo de la marca
En esta sección, se proporcionan lineamientos de la experiencia del usuario para agregar elementos de desarrollo de la marca a la interfaz del complemento.
En tu complemento
Si quieres incluir desarrollo de la marca en la IU del complemento, hazlo de forma breve y sencilla. Esto ayuda a las personas a enfocarse en la funcionalidad del complemento.
- Todos los aspectos de tu complemento deben seguir los lineamientos de desarrollo de la marca.
- No incluyas las palabras "Google", "Gmail" ni otros nombres de productos de Google.
- No incluyas íconos de productos de Google, incluso si están modificados.
- No incluyas la palabra "complemento" en el texto de desarrollo de la marca.
- El texto de desarrollo de la marca no debe tener más de unas pocas palabras.
En Google Workspace Marketplace
Cuando configuras tu complemento para su publicación, proporcionas una cantidad de recursos gráficos y de texto para crear la ficha de Google Workspace Marketplace.
Todos los aspectos de la ficha de Play Store y estos recursos deben seguir los lineamientos de desarrollo de la marca.