Después de crear una app de Chat, puedes publicarla a fin de que esté disponible para personas o grupos seleccionados, todos los miembros de tu organización de Google Workspace o cualquier usuario de Google Chat que tenga una cuenta de Google Workspace.
Cómo descubren y usan los usuarios las apps de Google Chat
Para descubrir las apps de Google Chat, los usuarios pueden realizar cualquiera de las siguientes acciones:
- Busca e instala apps de Google Chat.
- Interactúa con una app que se agregó a un espacio de Chat.
- Descubre la app en su panel de mensajes directos después de que un administrador de Google Workspace la haya instalado en su nombre.
Para comenzar a usar una app, los usuarios de Google Chat pueden iniciar un mensaje directo con la app o agregarla a un espacio. Los usuarios también pueden mencionar la app con @. En el siguiente ejemplo, se muestra cómo un usuario @ menciona una app de chat para agregarla a un espacio:
Como alternativa, los administradores de Google Workspace pueden encontrar apps de chat en Google Workspace Marketplace y instalarlas para los usuarios de su organización. Cuando los administradores instalan una app de Chat, esta aparece en el panel de mensajes directos de los usuarios.
Los administradores de Google Workspace también pueden administrar y agregar a la lista de entidades permitidas el uso de las apps de chat en su organización de Google Workspace. Si estás desarrollando una app de chat para una organización que usa listas de entidades permitidas, debes solicitar que un administrador agregue tu app de chat a la lista de entidades permitidas para que los usuarios puedan encontrarla y usarla. Si deseas obtener más información, consulta la documentación de la Ayuda para administradores de Google Workspace, Permitir que los usuarios instalen apps de chat.
Configura y publica tu app de Chat con la consola de Google Cloud
A fin de publicar tu app de Chat y ponerla a disposición de otros, por lo general, debes seguir estos pasos:
- Habilita y configura la API de Google Chat. Cuando configuras la API, otorgas a otros usuarios de Google Chat acceso a tu app de Chat para realizar pruebas.
- Publica tu app con el SDK de Google Workspace Marketplace. Puedes configurar tu app de Chat para que esté disponible para los usuarios de tu organización de Google Workspace o para todos los usuarios de Google Chat.
- Si tu organización de Google Workspace administra el acceso a las apps de Chat, solicita que el administrador de Google Workspace agregue la app a la lista de entidades permitidas de la organización.
Configuración de visibilidad y publicación de tu app de chat
En la siguiente tabla, se explica cómo establecer la configuración de la API de Google Chat y el SDK de Google Workspace Marketplace según el público de la app de Chat:
. . . .| Estoy compilando una app de chat... | Método de autenticación | Configuración de la API de Google Chat | Configuración del SDK de Google Workspace Marketplace | ¿Dónde se publica mi app de Chat? |
|---|---|---|---|---|
| ...Para mi pequeño equipo | Autentícate como usuario o como app. | En la configuración de Visibilidad, especifica las personas o los Grupos de Google que pueden acceder a la app.
Si tu cuenta de Google Workspace requiere que las apps se incluyan en la lista de entidades permitidas, solo puedes especificar hasta 5 direcciones de correo electrónico individuales (no puedes especificar Grupos de Google). |
No necesitas configurar el SDK de Google Workspace Marketplace para tu app de chat. | Los miembros del equipo pueden encontrar y usar la app de Chat desde Google Chat. |
| ...para mi equipo grande | Autentícate como usuario o como app. | En la configuración de Visibilidad, especifica personas o Grupos de Google para probar tu app de Chat.
Después de realizar las pruebas, publica la app de Chat en tu organización de Google Workspace con la configuración del SDK de Google Workspace Marketplace. |
Configura la Visibilidad de la app como Privada. Configure Installation settings como Individual + Admin. Si tu cuenta de Google Workspace requiere que las apps se incluyan en la lista de entidades permitidas, solicita que un administrador agregue tu app de Chat a la lista de entidades permitidas para que los usuarios puedan encontrarla y usarla. Si deseas obtener más información, consulta la documentación de ayuda para administradores de Google Workspace, Permitir que los usuarios instalen apps de chat. |
Cualquier miembro de tu organización de Google Workspace puede buscar y, luego, instalar tu app de chat en Google Chat, además de ver la app en Google Workspace Marketplace. Los usuarios y los administradores de Google Workspace pueden instalar tu app desde Marketplace. |
| ...Para mi organización de Google Workspace | Autentícate como usuario o como app. | En la configuración de Visibilidad, especifica personas o Grupos de Google para probar tu app de Chat.
Después de realizar las pruebas, publica la app de Chat en tu organización de Google Workspace con la configuración del SDK de Google Workspace Marketplace. |
Configura la Visibilidad de la app como Privada. Configure Installation settings como Individual + Admin. |
Cualquier miembro de tu organización de Google Workspace puede buscar y, luego, instalar tu app de chat en Google Chat, además de ver la app en Google Workspace Marketplace. Solo los administradores de Google Workspace pueden instalar tu app desde Marketplace. |
| ...para todos (app pública de Chat) | Autentícate como una app. | En la configuración de Visibilidad, especifica personas o Grupos de Google para probar tu app de Chat.
Después de realizar las pruebas, publica tu app de Chat públicamente con la configuración de Google Workspace Marketplace. |
Configure Visibilidad de la aplicación como Público. Configure Installation settings como Individual + Admin. |
Cualquier usuario de Google Workspace puede buscar e instalar tu app de Chat en Google Chat, y verla en Google Workspace Marketplace. Solo los administradores de Google Workspace pueden instalar tu app desde Marketplace. |
Cómo habilitar y configurar la API de Google Chat
Configura un proyecto para tu app en Google API Console y habilita la API de Google Chat.
- Usa el botón que aparece a continuación para crear un proyecto nuevo (o selecciona uno existente) y agrégale una cuenta de servicio. Asigna a la cuenta de servicio la función de Propietario del proyecto.
Habilitar la API - Guarda la clave JSON descargada. Tu app puede usar esta clave para autenticar los mensajes que envía a los espacios de forma asíncrona.
- Abre tu proyecto en API Console. En la lista de APIs, haz clic en API de Google Chat.
- Selecciona la pestaña Configuración y, luego, ingresa la información de la app, como se describe en la siguiente tabla.
Cuando guardes la configuración de la app, esta estará disponible para los usuarios especificados en tu organización de Google Workspace.
Configuración de la API de Google Chat
| Campo | Descripción |
|---|---|
| Nombre de la app | Es el nombre que las personas usan cuando interactúan con tu app. |
| URL del avatar | Una URL HTTPS que dirija a una imagen gráfica cuadrada (p.ej., PNG o JPEG), de al menos 128 x 128, que aparecerá como avatar de la app. |
| Descripción | Una descripción de la funcionalidad de la app que aparece debajo del nombre de la app |
| Funcionalidad | Un conjunto de campos que determinan qué eventos pueden activar la app:
|
| Configuración de conexión | El extremo de la aplicación, que es uno de los siguientes:
|
| Comandos de barra | Comandos que se pueden mostrar a los usuarios dentro de Google Chat Permite que los usuarios vean las acciones principales de tu app en Google Chat y elijan una acción específica con la que desean interactuar. |
| Vista previa del vínculo | Patrones de URL que la app reconoce y proporciona contenido adicional cuando los usuarios envían vínculos. Para obtener más información, consulta Desviar URL. |
| Visibilidad | Hasta 5 personas o uno o más Grupos de Google que puedan ver e instalar tu app de Chat. Usa este campo para probarla o compartirla con tu equipo. Para obtener más información, consulta la configuración de Visibilidad y publicación de tu app de Chat. |
Otorga permisos de configuración de la app
Puedes otorgar acceso a la página de configuración de la app a usuarios específicos. Para ello, usa las funciones de IAM Propietario de apps de chat y Visualizador de apps de chat. Los usuarios con estas funciones no pueden navegar a la página de configuración de la app mediante el panel API y servicios, pero pueden navegar a la consola para acceder a la página de configuración del proyecto de la siguiente manera:
https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=your-project-id
Publica tu app con el SDK de Google Workspace Marketplace
Usa el SDK de Google Workspace Marketplace para lo siguiente:
- Publica tu app de forma pública y permite que cualquier usuario de Google Chat la agregue a un espacio.
- Publica la app en tu dominio.
- Haz que tu app esté visible para los administradores de Google Workspace a fin de que puedan instalarla para los usuarios de su organización. Para que los administradores de Google Workspace puedan verla, la app debe incluir mensajes directos.
Antes de publicar tu app con el SDK de Google Workspace Marketplace, sigue estos pasos:
- Instálala desde Chat para probarla. Asegúrate de que tu app funcione por completo y no sea un trabajo en curso.
- Revisa los requisitos de publicación y verifica que tu app cumpla con todos. Consulta Áreas de revisión.
- Registra el número de versión de tu app, ya que lo necesitarás para configurar el SDK de Google Workspace Marketplace.
Cuando estés listo para publicar, consulta Descripción general: Cómo publicar una app.
Cómo inhabilitar tu app de Chat
Después de guardar la página de configuración, aparecerá el campo App Status (Estado de la app). Este campo te permite controlar si la app está Live o Disabled.
Para inhabilitar una app de Chat, sigue estos pasos:
- Abre la consola de Google Cloud
- Si es necesario, selecciona el proyecto de Google Cloud que aloja la
app de Chat:
- Junto a "Google Cloud", haz clic en la flecha hacia abajo . Aparecerá un diálogo en el que se enumeran los proyectos actuales.
- Selecciona el proyecto que aloja la app de Chat migrada.
- Haz clic en Open.
- Busca "API de Google Chat" y haz clic en API de Google Chat.
- Haz clic en Administrar.
- Haz clic en Configuración.
- En la sección "Estado de la aplicación", seleccione Inhabilitada.
- Haz clic en Guardar.