Nivel de programación: Intermedio
Duración: 30 minutos
Tipo de proyecto: Complemento de Google Workspace
Objetivos
- Comprende qué hace el complemento.
- Comprende cómo compilar un complemento con Apps Script y comprende qué hacen los servicios de Apps Script.
- Configurar el entorno
- Configura la secuencia de comandos.
- Ejecuta la secuencia de comandos.
Acerca de este complemento de Google Workspace
En esta muestra, crearás un complemento de Google Workspace que muestra una vista previa de los vínculos de Google Libros en un documento de Documentos de Google. Cuando escribes o pegas una URL de Google Libros en un documento, el complemento reconoce el vínculo y activa una vista previa. Para obtener una vista previa del vínculo, puedes convertirlo en un chip inteligente y mantener el puntero sobre el vínculo para ver una tarjeta que muestre más información sobre el libro.
Este complemento usa el servicio UrlFetch de Apps Script para conectarse a la API de Google Libros y obtener información sobre Google Libros que se mostrará en Documentos de Google.
Cómo funcionan
En el archivo de manifiesto del complemento de Google Workspace, la secuencia de comandos configura el complemento para extender Documentos de Google y activar vistas previas de vínculos para las URLs que coinciden con ciertos patrones del sitio web de Google Libros (https://books.google.com
).
En el archivo de código, la secuencia de comandos se conecta a la API de Google Libros y usa la URL para obtener información sobre el libro (que es una instancia del recurso Volume
). La secuencia de comandos usa esta información para generar un chip inteligente que muestra el título del libro y una tarjeta de vista previa con un resumen, la cantidad de páginas, una imagen de la portada del libro y la cantidad de calificaciones.
Servicios de Apps Script
Este complemento usa los siguientes servicios:
- Servicio UrlFetch: se conecta a la API de Google Libros para obtener información sobre libros (que son instancias del recurso
Volume
de las API). - Servicio de tarjetas: Crea la interfaz de usuario del complemento.
Requisitos previos
Para usar esta muestra, necesitas los siguientes requisitos previos:
- Una Cuenta de Google (es posible que las cuentas de Google Workspace requieran la aprobación del administrador)
Un navegador web con acceso a Internet
Un proyecto de Google Cloud con una cuenta de facturación asociada. Consulta Habilita la facturación para un proyecto.
Configura tu entorno.
En las siguientes secciones, se configura el entorno para compilar el complemento.
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.
Activa la API de Google Libros
Este complemento se conecta a la API de Google Books. 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 tu proyecto de Cloud, activa la API de Books.
Cómo configurar la pantalla de consentimiento de OAuth
Este complemento requiere un proyecto de Cloud con una pantalla de consentimiento configurada. La configuración de la pantalla de consentimiento de OAuth define lo que Google muestra a los usuarios y registra tu app para que puedas publicarla más tarde.
- 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 usar fuera de tu organización de Google Workspace, deberás cambiar el Tipo de usuario a Externo y, luego, agregar los permisos de autorización que requiere la app.
- Revisa el resumen del registro de tu app. Para realizar cambios, haz clic en Editar. Si el registro de la app parece correcto, haz clic en Volver al panel.
Obtén una clave de API para la API de Google Libros
- Ve a la consola de Google Cloud. Asegúrate de que tu proyecto con facturación habilitada esté abierto.
En la consola de Google Cloud, ve a Menú > APIs y servicios > Credenciales.
Haz clic en Crear credenciales > Clave de API.
Toma nota de tu clave de API para usarla en un paso posterior.
Configura la secuencia de comandos
En las siguientes secciones, se configura la secuencia de comandos para compilar el complemento.
Crea el proyecto de Apps Script
- Haz clic en el siguiente botón para abrir el proyecto de Apps Script Obtener vista previa de los vínculos de Google Libros.
Abrir el proyecto - Haz clic en Descripción general.
- En la página de descripción general, haz clic en Crear una copia.
- En tu copia del proyecto de Apps Script, ve al archivo
Code.gs
y reemplazaYOUR_API_KEY
por la clave de API que generaste en la sección anterior.
Copia el número del proyecto de la nube
- En la consola de Google Cloud, ve a Menú > IAM y administración > Configuración.
- Copia el valor en el campo Número del proyecto.
Configura el proyecto de Cloud del proyecto de Apps Script
- En tu proyecto de 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.
Prueba el complemento
En las siguientes secciones, se prueba el complemento que creaste.
Instala una implementación de prueba
- En tu proyecto de Apps Script, haz clic en Editor.
- Reemplaza
YOUR_API_KEY
por la clave de API para la API de Google Libros, creada en una sección anterior. - Haz clic en Implementar > Implementaciones de prueba.
- Haz clic en Instalar > Listo.
Cómo obtener una vista previa de un vínculo en Documentos de Google
- Crea un documento de Documentos de Google en docs.new.
- Pega la siguiente URL en el documento y presiona la tecla tab para convertir la URL en un chip inteligente:
https://www.google.com/books/edition/Software_Engineering_at_Google/V3TTDwAAQBAJ
- Mantén el puntero sobre el chip inteligente y, cuando se te solicite, autoriza el acceso para ejecutar el complemento. La tarjeta de vista previa muestra información sobre el libro.
En la siguiente imagen, se muestra la vista previa del vínculo:
Revisa el código
Para revisar el código de Apps Script de este complemento, haz clic en Ver código fuente para expandir la sección:
Ver el código fuente
appsscript.json
Code.gs
Temas relacionados
- Cómo obtener una vista previa de vínculos con chips inteligentes
- Documentación de referencia de la API de Google Books