Compila un complemento de Google Workspace con Node.js

Crear complementos de Google Workspace en Cloud Functions con el entorno de ejecución de Node.js

Objetivos

  • Configurar el entorno
  • Crear e implementar una Cloud Function
  • Crea e implementa el complemento.
  • Instala el complemento.

Requisitos previos

Configura tu entorno

Abre tu proyecto de Cloud en la consola de Google Cloud

  1. En la consola de Google Cloud, ve a la página Selecciona un proyecto.

    Selecciona un proyecto de Cloud

  2. 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.

Cómo configurar la pantalla de consentimiento de OAuth

Los complementos de Google Workspace requieren una configuración de pantalla de consentimiento. Configurando la pantalla de consentimiento de OAuth de tu complemento define lo que Google muestra a los usuarios.

  1. En la consola de Google Cloud, ve a Menú > APIs y Servicios > Pantalla de consentimiento de OAuth.

    Ir a la pantalla de consentimiento de OAuth

  2. En Tipo de usuario, selecciona Interno y, luego, haz clic en Crear.
  3. Completa el formulario de registro de apps y, luego, haz clic en Guardar y continuar.
  4. 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.

  5. 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.

Crea e implementa una Cloud Function

  1. En una terminal local, activa Cloud Functions, Cloud Build y API de complementos de Google Workspace:

    gcloud services enable cloudfunctions cloudbuild.googleapis.com gsuiteaddons.googleapis.com
    
  2. En un directorio vacío, crea el archivo function.js con la siguiente información: código de muestra:

    /**
     * Cloud Function that loads the homepage for a
     * Google Workspace Add-on.
     *
     * @param {Object} req Request sent from Google
     * @param {Object} res Response to send back
     */
    exports.loadHomePage = function addonsHomePage (req, res) {
      res.send(createAction());
    };
    
    /** Creates a card with two widgets. */
    function createAction() {
      return {
        "action": {
          "navigations": [
            {
              "pushCard": {
                "header": {
                  "title": "Cats!"
                },
                "sections": [
                  {
                    "widgets": [
                      {
                        "textParagraph": {
                          "text": "Your random cat:"
                        }
                      },
                      {
                        "image": {
                          "imageUrl": "https://cataas.com/cat"
                         }
                      }
                    ]
                  }
                ]
              }
            }
          ]
        }
      };
    }
    
  3. Sigue estos pasos para implementar la función:

    gcloud functions deploy loadHomePage --runtime nodejs12 --trigger-http
    

    Si se te solicita, especifica que no permites invocaciones no autenticadas de la . Es posible que la función tarde algunos minutos en implementarse.

Crea una implementación de complementos

  1. Busca el correo electrónico de la cuenta de servicio del complemento:

    gcloud workspace-add-ons get-authorization
    
  2. Otorga a la cuenta de servicio el rol cloudfunctions.invoker:

    gcloud functions add-iam-policy-binding loadHomePage \
        --role roles/cloudfunctions.invoker \
        --member serviceAccount:SERVICE_ACCOUNT_EMAIL
    
  3. Obtén la URL de la función implementada. Para obtener la URL, ejecuta el siguiente comando: y busca el campo url en la sección httpsTrigger:

    gcloud functions describe loadHomePage
    
  4. Crea el archivo deployment.json con el siguiente código de muestra. Reemplazar URL por la URL de la función implementada desde la paso anterior.

    {
      "oauthScopes": ["https://www.googleapis.com/auth/gmail.addons.execute"],
      "addOns": {
        "common": {
          "name": "My HTTP Add-on",
          "logoUrl": "https://raw.githubusercontent.com/webdog/octicons-png/main/black/beaker.png",
          "homepageTrigger": {
            "runFunction": "URL"
          }
        },
        "gmail": {},
        "drive": {},
        "calendar": {},
        "docs": {},
        "sheets": {},
        "slides": {}
      }
    }
    
  5. Crea la implementación:

    gcloud workspace-add-ons deployments create quickstart \
        --deployment-file=deployment.json
    

Cómo instalar el complemento

  1. Instala la implementación en modo de desarrollo:

    gcloud workspace-add-ons deployments install quickstart
    
  2. Abre o vuelve a cargar Gmail para ver el complemento. En en la barra de herramientas de la derecha, busca el ícono del vaso de laboratorio.

  3. Haz clic en el ícono para abrir el complemento. Si se te solicita, autorizar el complemento.

Opcional: Limpieza

Para evitar que se apliquen cargos a tu cuenta, borra los recursos que fecha de creación:

  1. Desinstala el complemento de tu Cuenta de Google:

    gcloud workspace-add-ons deployments uninstall quickstart
    
  2. Para evitar que se apliquen cargos por los recursos que usaste en esta guía de inicio rápido, borra proyecto de Cloud:

    gcloud projects delete PROJECT_ID
    

    Reemplaza PROJECT_ID por el ID del proyecto de Cloud. que usaste para la guía de inicio rápido. Puedes encontrar el ID del proyecto de Cloud en la consola de Google Cloud en la Página Panel de control.

Próximos pasos

Para agregar más funciones a tu complemento de Google Workspace, consulta el las siguientes guías: