GSP249

Descripción general

Los complementos de Gmail automatizan las tareas en Gmail, lo que les permite a los usuarios ahorrar tiempo y esfuerzo. Además, estos complementos pueden examinar mensajes entrantes y, luego, ejecutar distintas acciones. Por ejemplo:

• Mostrar información adicional para el usuario en la IU de Gmail
• Establecer conexión con servicios ajenos a Google a fin de recuperar información o realizar otras acciones
• Proporcionar una interfaz interactiva que permita al usuario controlar el complemento o enviar información a otro servicio

Actividades

En este lab práctico, crearás un complemento de Gmail que te permitirá cambiar rápidamente las etiquetas de una conversación de correo electrónico.

Configuración y requisitos

Antes de hacer clic en el botón Comenzar lab

Lee estas instrucciones. Los labs son cronometrados y no se pueden pausar. El cronómetro, que comienza a funcionar cuando haces clic en Comenzar lab, indica por cuánto tiempo tendrás a tu disposición los recursos del lab.

Este lab práctico te permitirá llevar a cabo las actividades correspondientes en un entorno de nube real, no en uno de simulación o demostración. Para ello, te proporciona credenciales temporales nuevas que utilizarás para acceder a Gmail durante todo el lab.

Requisitos

Para completar este lab, necesitarás lo siguiente:

• Acceso a un navegador de Internet estándar (se recomienda el navegador Chrome)
• Tiempo para completar el lab

1. Asegúrate de acceder al lab usando una ventana de incógnito.

2. Cuando tengas todo listo, haz clic en .

   Aparecerá un panel nuevo con las credenciales temporales que debes usar en este lab.

   Si debes pagar por el lab, se abrirá una ventana emergente para que selecciones tu forma de pago.

3. Toma nota de tus credenciales del lab. Las usarás para acceder a Gmail en este lab.

   Si usas otras credenciales, se generarán errores o se incurrirá en cargos.

4. Haz clic en Abrir Gmail.

5. Haz clic en Siguiente en el diálogo Acceder.

6. Ingresa la contraseña proporcionada y haz clic en Siguiente.

7. Si es necesario, haz clic en Aceptar para aceptar las condiciones.

Se abrirá Gmail. Haz clic en Comenzar y, luego, cierra cualquier ventana adicional de información.

Ahora te encuentras en Gmail, en tu carpeta Recibidos.

Tarea 1. Crea el proyecto de secuencia de comandos

Inicia Apps Script

1. Haz clic en este vínculo de Apps Script para abrirlo en una nueva ventana del navegador o pestaña. Se abrirá un nuevo proyecto.

Nota: Apps Script coloca el archivo del proyecto en tu carpeta raíz de Drive.

2. Haz clic en el ícono Configuración y, luego, selecciona la opción Mostrar el archivo de manifiesto "appsscript.json" en el editor.

3. Haz clic en el ícono Editor.

Asígnale un nombre al proyecto

1. Haz clic en Proyecto sin título en la parte superior izquierda.
2. Asígnale el nombre Guía de inicio rápido sobre el Complemento de Gmail al proyecto y, luego, haz clic en Cambiar nombre.

Crea el archivo de secuencia de comandos Code.gs

• Reemplaza los contenidos del archivo Code.gs por lo siguiente:

Code.gs

/** * Copyright Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * https://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ /** * Returns the array of cards that should be rendered for the current * e-mail thread. The name of this function is specified in the * manifest 'onTriggerFunction' field, indicating that this function * runs every time the add-on is started. * * @param {Object} e The data provided by the Gmail UI. * @return {Card[]} */ function buildAddOn(e) { // Activate temporary Gmail add-on scopes. var accessToken = e.messageMetadata.accessToken; GmailApp.setCurrentMessageAccessToken(accessToken); var messageId = e.messageMetadata.messageId; var message = GmailApp.getMessageById(messageId); // Get user and thread labels as arrays to enable quick sorting and indexing. var threadLabels = message.getThread().getLabels(); var labels = getLabelArray(GmailApp.getUserLabels()); var labelsInUse = getLabelArray(threadLabels); // Create a section for that contains all user Labels. var section = CardService.newCardSection() .setHeader("<font color=\"#1257e0\"><b>Available User Labels</b></font>"); // Create a checkbox group for user labels that are added to prior section. var checkboxGroup = CardService.newSelectionInput() .setType(CardService.SelectionInputType.CHECK_BOX) .setFieldName('labels') .setOnChangeAction(CardService.newAction().setFunctionName('toggleLabel')); // Add checkbox with name and selected value for each User Label. for(var i = 0; i < labels.length; i++) { checkboxGroup.addItem(labels[i], labels[i], labelsInUse.indexOf(labels[i])!= -1); } // Add the checkbox group to the section. section.addWidget(checkboxGroup); // Build the main card after adding the section. var card = CardService.newCardBuilder() .setHeader(CardService.newCardHeader() .setTitle('Quick Label') .setImageUrl('https://www.gstatic.com/images/icons/material/system/1x/label_googblue_48dp.png')) .addSection(section) .build(); return [card]; } /** * Updates the labels on the current thread based on * user selections. Runs via the OnChangeAction for * each CHECK_BOX created. * * @param {Object} e The data provided by the Gmail UI. */ function toggleLabel(e){ var selected = e.formInputs.labels; // Activate temporary Gmail add-on scopes. var accessToken = e.messageMetadata.accessToken; GmailApp.setCurrentMessageAccessToken(accessToken); var messageId = e.messageMetadata.messageId; var message = GmailApp.getMessageById(messageId); var thread = message.getThread(); if (selected != null){ for each (var label in GmailApp.getUserLabels()) { if(selected.indexOf(label.getName()) != -1){ thread.addLabel(label); } else { thread.removeLabel(label); } } } else { for each (var label in GmailApp.getUserLabels()) { thread.removeLabel(label); } } } /** * Converts an GmailLabel object to a array of strings. * Used for easy sorting and to determine if a value exists. * * @param {labelsObjects} A GmailLabel object array. * @return {lables[]} An array of labels names as strings. */ function getLabelArray(labelsObjects){ var labels = []; for(var i = 0; i < labelsObjects.length; i++) { labels[i] = labelsObjects[i].getName(); } labels.sort(); return labels; } Nota: Antes de guardar, deberás actualizar el manifiesto de la secuencia de comandos para evitar errores.

Tarea 2: Actualiza el manifiesto de la secuencia de comandos

Actualiza el manifiesto (appsscript.json) para proporcionarle al complemento la información de implementación necesaria.

1. En el editor de secuencia de comandos, selecciona el archivo appsscript.json en el menú de la izquierda.
2. Reemplaza el contenido del manifiesto (appsscript.json) por lo siguiente:

appsscript.json

{ "oauthScopes": [ "https://www.googleapis.com/auth/gmail.addons.execute", "https://www.googleapis.com/auth/gmail.addons.current.message.metadata", "https://www.googleapis.com/auth/gmail.modify" ], "gmail": { "name": "Gmail Add-on Quickstart - QuickLabels", "logoUrl": "https://www.gstatic.com/images/icons/material/system/1x/label_googblue_24dp.png", "contextualTriggers": [{ "unconditional": { }, "onTriggerFunction": "buildAddOn" }], "openLinkUrlPrefixes": [ "https://mail.google.com/" ], "primaryColor": "#4285F4", "secondaryColor": "#4285F4" } }

3. Haz clic en el ícono Guardar proyecto para guardar los cambios del manifiesto y de Code.gs. En este paso, se proporciona al complemento la información de implementación necesaria. Si recibes un mensaje de error, vuelve a guardar Code.gs.

Crear un nuevo proyecto de Apps Script

Tarea 3: Implementa el complemento

1. Haz clic en el botón Implementar > Implementaciones de prueba en la parte superior de la pantalla.

2. En Aplicaciones: Gmail, haz clic en Instalar.

3. Haz clic en Listo.

4. Abre la pestaña Complementos de la configuración de Gmail.

5. Esto te llevará al cuadro de diálogo Configuración en la pestaña Complementos.

Cuando hayas completado estos pasos, el complemento aparecerá en la lista Complementos de programador instalados y comenzará a estar disponible para que lo uses con Gmail.

Nota: Si no ves tu complemento en la lista Complementos de programador instalados, actualiza la ventana del navegador. Si el complemento aún no está en la lista, vuelve a la pestaña Guía de inicio rápido sobre el Complemento de Gmail, desinstala y reinstala el complemento desde la ventana Implementaciones de prueba.

Tarea 4. Ejecuta el complemento

1. Vuelve a la pestaña de Gmail y actualízala.
2. Selecciona y abre un mensaje en Gmail.
3. Asegúrate de que el menú lateral derecho esté abierto; haz clic en la flecha para expandirlo si está contraído.

Crea algunas etiquetas.

1. Haz clic en el botón Etiquetas () ubicado en la barra de menú de Gmail, en la parte superior del correo electrónico.
2. Haz clic en Crear nueva.
3. Ingresa "Test 1" como nombre de la etiqueta y haz clic en el botón Crear.
4. Repite estos pasos para crear otra etiqueta con el nombre “Test 2”.

Autoriza el complemento

Los complementos que instalaste aparecen en el menú derecho de la conversación de correo electrónico abierta.

1. En la parte derecha de la pantalla, haz clic en .

El complemento mostrará una tarjeta contextual en el lado derecho de la ventana con un mensaje que solicita autorización.

2. Haz clic en el vínculo Autorizar acceso para que se abra un cuadro diálogo en el que podrás autorizar el complemento.
3. Selecciona la cuenta de estudiante que debería autorizar el complemento.
4. Haz clic en Permitir.
5. Si el siguiente cuadro de diálogo te informa que la aplicación no está verificada:

• Haz clic en Configuración avanzada.
• En la parte inferior del diálogo, haz clic en Guía de inicio rápido sobre el Complemento de Gmail (no seguro).
• En el nuevo diálogo, escribe "Continuar" en el campo de texto y haz clic en Siguiente.

6. Una vez autorizado, el complemento debería actualizarse automáticamente y comenzar a funcionar.

Tarea 5: Usa el complemento

Las etiquetas Test 1 y Test 2 están marcadas en la sección Etiquetas de usuario disponibles del complemento (menú lateral derecho).

1. Haz clic en la casilla de verificación Test 2 para anular la selección de la etiqueta. Esto quitará la etiqueta de la conversación de correo electrónico en la que te encuentras actualmente.
2. Verifica que se hayan aplicado las etiquetas correctas. Para ello, vuelve a Recibidos y actualiza el navegador. Solo está aplicada la etiqueta Test 1 y se quitó Test 2.
3. Abre un correo electrónico diferente.
4. En el menú de complementos, selecciona las casillas de verificación Test 1 y Test 2, para habilitar ambas etiquetas.
5. Vuelve a Recibidos y actualiza el navegador. Ambas etiquetas se aplicaron a la conversación de correo electrónico.

Crear y usar el complemento de Gmail

¡Felicitaciones!

Ahora sabes lo que pueden hacer los complementos de Gmail. También podrías realizar muchas acciones más, como mostrar otras conversaciones recientes que inició el remitente o traducir el texto de un correo electrónico de un idioma a otro sin salir de Gmail.

Finaliza la Quest

Este lab de autoaprendizaje forma parte de la Quest Workspace Integrations. Una Quest es una serie de labs relacionados que forman una ruta de aprendizaje. Si completas esta Quest, obtendrás una insignia como reconocimiento por tu logro. Puedes hacer públicas tus insignias y agregar vínculos a ellas en tu currículum en línea o en tus cuentas de redes sociales. Inscríbete en cualquier Quest que contenga este lab y obtén un crédito inmediato de finalización. Consulta el catálogo de Google Cloud Skills Boost para ver todas las Quests disponibles.

Realiza tu próximo lab

Más información sobre Workspace:

• Google Apps Script: Accede a Hojas de cálculo de Google, Maps y Gmail con 4 líneas de código

Próximos pasos

• Más información sobre los complementos de Gmail
• Centro de aprendizaje de Google Workspace

Capacitación y certificación de Google Cloud

Recibe la formación que necesitas para aprovechar al máximo las tecnologías de Google Cloud. Nuestras clases incluyen habilidades técnicas y recomendaciones para ayudarte a avanzar rápidamente y a seguir aprendiendo. Para que puedas realizar nuestros cursos cuando más te convenga, ofrecemos distintos tipos de capacitación de nivel básico a avanzado: a pedido, presenciales y virtuales. Las certificaciones te ayudan a validar y demostrar tus habilidades y tu conocimiento técnico respecto a las tecnologías de Google Cloud.

Última actualización del manual: 16 de febrero de 2023

Prueba más reciente del lab: 16 de febrero de 2023

Copyright 2024 Google LLC. All rights reserved. Google y el logotipo de Google son marcas de Google LLC. Los demás nombres de productos y empresas pueden ser marcas de las respectivas empresas a las que estén asociados.