Questa pagina è stata tradotta dall'API Cloud Translation.

Creare un componente aggiuntivo di Google Workspace con Node.js
Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Crea componenti aggiuntivi di Google Workspace in Cloud Functions utilizzando il runtime Node.js.

Obiettivi

Configurare l'ambiente.
Crea ed esegui il deployment di una funzione Cloud.
Crea e implementa il componente aggiuntivo.
Installa il componente aggiuntivo.

Prerequisiti

Un progetto Google Cloud.
Assicurati di attivare la fatturazione per il tuo progetto Cloud. Scopri come verificare lo stato della fatturazione dei tuoi progetti.
Cloud SDK è configurato con il progetto Cloud.

Configura l'ambiente

Apri il progetto Cloud nella console Google Cloud

Nella console Google Cloud, vai alla pagina Seleziona un progetto.
Seleziona un progetto Cloud
Seleziona il progetto Google Cloud che vuoi utilizzare. In alternativa, fai clic su Crea progetto e segui le istruzioni sullo schermo. Se crei un progetto Google Cloud, potresti dover attivare la fatturazione per il progetto.

Configura la schermata per il consenso OAuth

I componenti aggiuntivi di Google Workspace richiedono la configurazione di una schermata di consenso. La configurazione della schermata per il consenso OAuth del componente aggiuntivo definisce ciò che Google mostra agli utenti.

Nella console Google Cloud, vai a Menu > > Branding.
Vai a Branding
Se hai già configurato il , puoi configurare le seguenti impostazioni della schermata per il consenso OAuth in Branding, Pubblico e Accesso ai dati. Se viene visualizzato il messaggio non ancora configurato, fai clic su Inizia:

In Informazioni sull'app, in Nome app, inserisci un nome per l'app.
In Indirizzo email dell'assistenza utente, scegli un indirizzo email dell'assistenza a cui gli utenti possono contattarti in caso di domande sul loro consenso.
Fai clic su Avanti.
In Pubblico, seleziona Interno.
Fai clic su Avanti.
In Informazioni di contatto, inserisci un indirizzo email a cui ricevere notifiche di eventuali modifiche al progetto.
Fai clic su Avanti.
In Fine, esamina le Norme relative ai dati utente dei servizi API di Google e, se accetti, seleziona Accetto le Norme relative ai dati utente: servizi API di Google.
Fai clic su Continua.
Fai clic su Crea.

Per il momento, puoi saltare l'aggiunta degli ambiti. In futuro, quando crei un'app da utilizzare al di fuori della tua organizzazione Google Workspace, devi modificare il Tipo di utente in Esterno. Poi Aggiungi gli ambiti di autorizzazione richiesti dalla tua app. Per saperne di più, consulta la guida completa su come configurare il consenso OAuth.

Crea ed esegui il deployment di una funzione Cloud

Nella console Google Cloud, fai clic su Attiva Cloud Shell .

Attivare Cloud Shell

Il terminale Cloud Shell si apre e avvia una sessione nel riquadro inferiore della console Google Cloud.
Fai clic su Autorizza per eseguire il provisioning e connetterti a Cloud Shell.

Nel terminale Cloud Shell, attiva l'API Cloud Functions, l'API Cloud Build, l'API Componenti aggiuntivi di Google Workspace e l'API Compute Engine:

gcloud services enable cloudfunctions.googleapis.com  \
                    cloudbuild.googleapis.com  \
                    gsuiteaddons.googleapis.com  \
                    compute.googleapis.com

Avvia l'editor di Cloud Shell facendo clic su Apri editor nella barra degli strumenti della finestra di Cloud Shell.

Questo editor di codice integrato consente di visualizzare e modificare i file nello stesso ambiente in cui vengono creati e implementati i progetti.

Nella directory vuota, crea il file function.js con il seguente codice di esempio:

/**
 * 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"
                     }
                  }
                ]
              }
            ]
          }
        }
      ]
    }
  };
}

Nella stessa directory, crea il file package.json con il seguente codice di esempio:

{
  "dependencies": {
    "@google-cloud/functions-framework": "^3.0.0"
  }
}

Torna al terminale Cloud Shell facendo clic su Apri terminale.

Aggiungi il ruolo Cloud Build Service Account (roles/cloudbuild.builds.builder) all'account di servizio predefinito di Compute Engine.

Innanzitutto, configura l'autorizzazione per l'account di servizio:

export PROJECT_ID=$(gcloud config get project)
export SERVICE_ACCOUNT_NAME=$(gcloud compute project-info describe \
  --format="value(defaultServiceAccount)")

Poi, concedi l'autorizzazione all'account di servizio mancante:

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:$SERVICE_ACCOUNT_NAME" \
  --role="roles/cloudbuild.builds.builder"

Esegui il comando seguente per eseguire il deployment della funzione:
```
gcloud functions deploy loadHomePage --runtime nodejs22 --trigger-http
```
Se richiesto, specifica che non consenti le chiamate non autenticate della funzione. Il deployment della funzione potrebbe richiedere alcuni minuti.

Creare un deployment di componenti aggiuntivi

Trova l'indirizzo email dell'account di servizio per il componente aggiuntivo:
```
gcloud workspace-add-ons get-authorization
```

Concedi all'account di servizio il ruolo cloudfunctions.invoker. Sostituisci SERVICE_ACCOUNT_EMAIL con il campo serviceAccountEmail del passaggio precedente.

gcloud functions add-iam-policy-binding loadHomePage \
   --role roles/cloudfunctions.invoker \
   --member serviceAccount:SERVICE_ACCOUNT_EMAIL

Ottieni l'URL della funzione di cui è stato eseguito il deployment. Per ottenere l'URL, esegui il seguente comando e cerca il campo url nella sezione httpsTrigger:
```
gcloud functions describe loadHomePage
```
Torna all'editor di Cloud Shell facendo clic su Apri editor.

Nella stessa directory di package.json, crea il file deployment.json con il seguente codice di esempio. Sostituisci URL con url della funzione di cui è stato eseguito il deployment nel passaggio precedente.

{
  "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": {},
    "httpOptions": {
      "granularOauthPermissionSupport": "OPT_IN"
    }
  }
}

Torna al terminale Cloud Shell per creare il deployment:

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

Installazione del componente aggiuntivo

Installa il deployment in modalità di sviluppo:

gcloud workspace-add-ons deployments install quickstart

Apri o ricarica Gmail per visualizzare il componente aggiuntivo. Nella barra degli strumenti a destra, cerca l'icona di un becher.
Fai clic sull'icona per aprire il componente aggiuntivo. Se richiesto, autorizza il componente aggiuntivo.

(Facoltativo) Pulizia

Per evitare che al tuo account vengano addebitati costi, elimina le risorse che hai creato:

Disinstalla il componente aggiuntivo dal tuo Account Google:

gcloud workspace-add-ons deployments uninstall quickstart

Per evitare di incorrere in addebiti per le risorse utilizzate in questa guida rapida, elimina il progetto Cloud:
```
gcloud projects delete PROJECT_ID
```
Sostituisci PROJECT_ID con l'ID del progetto Cloud che hai utilizzato per la guida rapida. Puoi trovare l'ID progetto Cloud nella console Google Cloud nella pagina Dashboard.

Per aggiungere altre funzionalità al componente aggiuntivo di Google Workspace, consulta quanto segue: