Las guías de inicio rápido explican cómo configurar y ejecutar una app que llama a un API de Google Workspace.
Las guías de inicio rápido de Google Workspace usan las bibliotecas cliente de la API para controlar algunas los detalles del flujo de autenticación y autorización. Te recomendamos lo siguiente: usas las bibliotecas cliente para tus propias apps. En esta guía de inicio rápido, se usa un de autenticación simplificado, adecuado para realizar pruebas en un entorno de nube. Para un entorno de producción, recomendamos conocer autenticación y autorización antes de elige las credenciales de acceso que sean adecuados para tu app.
Crea un Google Apps Script que realiza solicitudes a la API de Google Chat.
Objetivos
- Configura el entorno.
- Crea y configura la secuencia de comandos.
- Ejecuta la secuencia de comandos.
Requisitos previos
- Una cuenta empresarial o empresarial de Google Workspace con acceso a Google Chat
Configura tu proyecto de Cloud
Si usas un proyecto de Google Cloud nuevo para completar esta guía de inicio rápido, debes hacer lo siguiente: configurarlo y agregarte como usuario de prueba. Si ya has completado estos pasos para tu proyecto de Cloud, pasa a la siguiente sección.
Abre tu proyecto de Cloud en la consola de Google Cloud
Si aún no está abierto, abre el proyecto de Cloud que quieres usar. para esta muestra:
- En la consola de Google Cloud, ve a la página Selecciona un proyecto.
- Selecciona el proyecto de Google Cloud que deseas usar. También puedes hacer clic en Crear proyecto y seguir las instrucciones en pantalla. Si creas un proyecto de Google Cloud, es posible que debas activar la facturación para el proyecto.
Activar la API de Chat
Antes de usar las APIs de Google, debes activarlas en un proyecto de Google Cloud. Puedes activar una o más APIs en un solo proyecto de Google Cloud.En la consola de Google Cloud, habilita la API de Google Chat.
Cómo configurar la pantalla de consentimiento de OAuth
- En la consola de Google Cloud, ve a Menú > APIs y Servicios > Pantalla de consentimiento de OAuth.
- En Tipo de usuario, selecciona Interno y, luego, haz clic en Crear.
- Completa el formulario de registro de apps y, luego, haz clic en Guardar y continuar.
Por ahora, puedes omitir el paso de agregar permisos y hacer clic en Guardar y continuar. En el futuro, cuando crees una app para usarla fuera de tu organización de Google Workspace, debes cambiar el Tipo de usuario a Externo y, luego, agregar los permisos de autorización que requiere tu app.
- Revisa el resumen del registro de tu app. Para realizar cambios, haz clic en Editar. Si la aplicación el registro parece estar bien, haz clic en Volver al panel.
Configura la app de Google Chat
Para llamar a la API de Google Chat, debes configurar una App de Google Chat Para cualquier solicitud de escritura, Google Chat atribuye la app de Google Chat en la IU con la siguiente información.
En la consola de Google Cloud, ve a la página Configuración de la API de Chat:
En Información de la aplicación, ingresa la siguiente información:
- En el campo Nombre de la app, ingresa
Chat API quickstart app
. - En el campo URL del avatar, ingresa
https://developers.google.com/chat/images/quickstart-app-avatar.png
- En el campo Descripción, ingresa
Quickstart for calling the Chat API
.
- En el campo Nombre de la app, ingresa
En Funciones interactivas, haz clic en Habilitar funciones interactivas. desactiva la opción para inhabilitar las funciones interactivas del App de Chat
Haz clic en Guardar.
Crea la secuencia de comandos
- Crea una nueva secuencia de comandos desde script.google.com/create.
- Reemplaza el contenido del editor de secuencia de comandos con el siguiente código:
- Haz clic en Guardar .
- Haz clic en Proyecto sin título, escribe Guía de inicio rápido y haz clic en Cambiar nombre.
Configura la secuencia de comandos
Copia el número del proyecto de la nube
- En la consola de Google Cloud, ve a Menú > IAM y Administrador > Configuración.
- Copia el valor en el campo Número del proyecto.
Vincula tu proyecto de Google Cloud
- Abre el proyecto Apps Script.
- Haz clic en Configuración del proyecto .
- En Proyecto de Google Cloud Platform (GCP), haz clic en Cambiar proyecto.
- En Número de proyecto de GCP, pega el número de proyecto de Google Cloud.
- Haz clic en Establecer el proyecto.
Habilita la API de Google Chat
- Abre el proyecto Apps Script.
- Haz clic en Configuración del proyecto .
- En Configuración general, habilita Mostrar "appsscript.json" archivo de manifiesto en el editor.
- Haz clic en Editor
appscript.json
y reemplaza el contenido por el siguiente código:
, selecciona
Ejecuta la muestra
En el editor de Apps Script, haz clic en Ejecutar.
La primera vez que ejecutes la muestra, se te solicitará que autorices el acceso:
- Haz clic en Revisar permisos.
- Elige una cuenta.
- Haz clic en Permitir.
El registro de ejecución de la secuencia de comandos aparece en la parte inferior de la ventana.