Configura la API de Google Chat

Cada app de Google Chat que crees requiere su propia Proyecto de Google Cloud con la API de Chat habilitada y configurada. Esta página se muestra cómo configurar la API de Chat.

Requisitos previos

Elige un nombre visible, un avatar y una descripción para tu app de Chat

Para llamar a la API de Chat, debes configurar una La app de Google Chat con la siguiente información:

Campo Descripción Formato
Nombre de la aplicación El nombre visible de la app de Chat. Puede tener hasta 25 caracteres alfanuméricos.
URL del avatar La imagen que se muestra como el de tu app de Chat avatar. Una URL HTTPS que dirige a una imagen de gráficos cuadrados (PNG o JPEG). El tamaño recomendado es de 256 por 256 píxeles o más.
Descripción Una breve descripción de que el propósito de la App de Chat Hasta 40 caracteres alfanuméricos

El nombre, el avatar y la descripción de la app de Chat que se muestra a los usuarios en la IU de Chat. Para algunas APIs de Chat solicitudes de escritura, Chat usa esta información para atribuir acciones que realiza una app de Chat en Chat.

Por ejemplo, si llamas al método spaces.create(), Chat incluye el nombre de la app de Chat en la descripción de quién creó el espacio, como se muestra en la siguiente imagen:

La app de Google Chat crea un espacio para un usuario.
Figura 1: El mensaje de atribución que Chat se muestra cuando se usa el método spaces.create() para crear un en nombre de un usuario.

Para interactuar con las apps de Chat, los usuarios también pueden ver o usar este información de las siguientes maneras:

  • Para invocar la app de Chat, @menciona su nombre.
  • Busca y, luego, inicia un mensaje directo con la app de Chat. En el menú Apps, los mensajes directos muestran las Nombre y avatar de la app de Chat.
  • Desde la barra para escribir, los usuarios pueden explorar las apps de Chat y ver su nombre, avatar y descripción.

Configura tu app de Chat en la consola de Google Cloud

Una vez que tengas los detalles de la app de Chat, abre la de Google Cloud y configura la API de Chat:

  1. En la consola de Google Cloud, ve a la página de la API de Chat y haz clic en Página Configuración:

    Ir a la página Configuración de la API de Chat

  2. En Información de la aplicación, completa los campos Nombre de la app y URL del avatar. y Description.

  3. En Funciones interactivas, haz clic en el botón de activación Habilitar funciones interactivas. en la posición de apagado para inhabilitar las funciones interactivas App de Chat Puedes configurar esto más tarde. Para obtener información sobre configurar y crear funciones interactivas, consulta Recibe y responde las interacciones de los usuarios.

  4. Opcional: En Registros, selecciona la casilla de verificación Registrar errores en Logging para usar Google Cloud Logging. Para obtener más información, consulta Consulta registros de errores de apps de Chat.

  5. Haz clic en Guardar.

Otorga permiso a otras personas para configurar una app de Chat

Puedes otorgar acceso a usuarios específicos a la página de configuración de la app de Chat. Usa el IAM de Propietario de apps de Chat y Visualizador de apps de Chat roles de seguridad. Los usuarios con estos roles no pueden navegar a las apps de Chat página de configuración con las APIs y de Google Cloud, pero puede acceder a la página de configuración navegando a la consola de Google Cloud del El proyecto host de Cloud de la app de Chat de la siguiente manera:

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

En el que PROJECT_ID es el ID del proyecto de la Proyecto de Google Cloud que aloja la app de Chat.