Eseguire il deployment di un componente aggiuntivo di Meet

I componenti aggiuntivi di Google Meet vengono creati e configurati nell'ambito di un progetto Google Cloud.

Nota: prima di seguire questa guida al deployment, devi creare un'app web che utilizzi l'SDK per i componenti aggiuntivi di Meet, quindi eseguire il deployment dell'app web su un sito web di tua proprietà.

Crea un progetto Google Cloud

Per generare un progetto Google Cloud, consulta Creare un progetto Google Cloud.

Attivare l'SDK di Google Workspace Marketplace e l'API Google Workspace Add-ons

L'SDK di Google Workspace Marketplace e l'API Google Workspace Add-ons sono necessari per sviluppare componenti aggiuntivi di Meet. Per attivarli:

1. Apri la console Google Cloud.
2. In alto, se è già aperto un altro progetto, seleziona il nome del progetto del progetto della tua app per cambiare progetto.
3. In alto, nella barra di ricerca, digita Google Workspace Marketplace SDK e premi Invio.

4. Apri la pagina Google Workspace Marketplace SDK e fai clic su Attiva.

   Avviso: assicurati di abilitare Google Workspace Marketplace SDK, non l'API. Google Workspace Marketplace API è uno strumento diverso utilizzato per l'integrazione con i servizi di licenze e fatturazione di Google.

5. Ripeti questi passaggi per trovare e attivare Google Workspace add-ons API.

Crea un deployment

Per utilizzare un componente aggiuntivo in Meet, devi disporre di un deployment e di un file manifest del componente aggiuntivo.

Vai all'SDK di Google Workspace Marketplace per il tuo progetto nella console Google Cloud.

1. Apri la console Google Cloud.
2. In alto, se è già aperto un altro progetto, seleziona il nome del progetto del progetto della tua app per cambiare progetto.
3. Fai clic su API e servizi.
4. Seleziona Google Workspace Marketplace SDK per visualizzare la pagina dei dettagli.

Crea il deployment

Puoi creare il deployment direttamente nella console Google Cloud creando un deployment HTTP (consigliato) o utilizzando Google Apps Script.

Deployment HTTP

1. Fai clic sulla scheda Deployment HTTP.

2. Fai clic su Crea nuovo deployment e inserisci l'ID di deployment del componente aggiuntivo.

   L'ID deployment è una stringa arbitraria che aiuta lo sviluppatore del componente aggiuntivo a identificare il deployment contenente il manifest del componente aggiuntivo. Gli ID dei deployment sono obbligatori e possono contenere al massimo 100 caratteri.

3. Fai clic su Avanti.

   Si apre un riquadro laterale in cui puoi inviare la specifica del manifest del componente aggiuntivo in formato JSON. Questo file è chiamato anche DEPLOYMENT.JSON.

   Il file manifest del componente aggiuntivo è la configurazione centrale di un componente aggiuntivo di Google Meet. Il seguente esempio di codice mostra i campi di Meet disponibili per il web nel file manifest del componente aggiuntivo.

   {
     "addOns": {
       "common": {
         "name": "NAME",
         "logoUrl": "LOGO_URL"
       },
       "meet": {
         "web": {
           "sidePanelUri": "SIDE_PANEL_URI",
           "addOnOrigins": ["ADD_ON_ORIGINS"],
           "darkModeLogoUrl": "DARK_MODE_LOGO_URL",
           "logoUrl": "MEET_WEB_LOGO_URL",
           "supportsScreenSharing": SUPPORTS_SCREENSHARING
         }
       }
     }
   }
   

   Sostituisci quanto segue:

   • NAME: stringa. Il nome del tuo componente aggiuntivo Google Meet.
   • LOGO_URL: stringa. L'URL del logo del componente aggiuntivo di Google Workspace. Viene utilizzato per il componente aggiuntivo nei prodotti Google Workspace.
   • SIDE_PANEL_URI: stringa. L'URL del punto di accesso dell'app componente aggiuntivo. Questo viene visualizzato in un iframe all'interno del riquadro laterale. L'origine di questo URL deve far parte delle origini specificate nel campo ADD_ON_ORIGINS.
   • ADD_ON_ORIGINS: Elenco di stringhe. Un elenco delle origini in cui è ospitato il tuo componente aggiuntivo. Due URL hanno la stessa origine quando condividono lo stesso schema, host e porta. Sono consentite anche le origini secondarie, così come i sottodomini con caratteri jolly. Per ulteriori informazioni, vedi Sicurezza dei componenti aggiuntivi.
   • DARK_MODE_LOGO_URL: stringa. Un URL specifico della modalità Buio del logo per il componente aggiuntivo. Fornire un logo per la modalità Buio assicura che il tuo componente aggiuntivo abbia un aspetto ottimale in qualsiasi tema di Meet. Per le linee guida per la progettazione del logo, consulta Best practice.
   • MEET_WEB_LOGO_URL: (Facoltativo) Stringa. Un URL specifico di Meet del logo del componente aggiuntivo. Questo logo viene utilizzato in tutto Meet. Se non è presente, viene utilizzato logoUrl della sezione comune. Per le linee guida per la progettazione dei loghi, consulta le best practice.
   • SUPPORTS_SCREENSHARING: (Facoltativo) Booleano. Se impostato su false, gli utenti devono utilizzare il componente aggiuntivo per vedere cosa succede in una sessione collaborativa del componente aggiuntivo. Se impostato su true, l'iniziatore della sessione del componente aggiuntivo collaborativo può condividere lo schermo della sua visualizzazione del componente aggiuntivo.

4. Fai clic su Invia.

   Per ulteriori informazioni sui deployment, vedi Creare una risorsa di deployment.

5. Nella scheda Configurazione app, in Integrazione app, seleziona Componente aggiuntivo Google Workspace. Seleziona Esegui il deployment utilizzando la risorsa di deployment cloud e poi scegli il deployment HTTP corretto.

Google Apps Script

1. Fai clic sulla scheda Configurazione app.

2. In Integrazione app, seleziona Componente aggiuntivo di Google Workspace. Seleziona Esegui il deployment utilizzando l'ID deployment di Google Apps Script e inserisci l'ID deployment dello script.

3. Fai clic su Salva.

   Per informazioni dettagliate su come creare un progetto Apps Script, consulta la documentazione di Apps Script. Il componente aggiuntivo Meet si basa esclusivamente sul file manifest appsscript.json, chiamato anche manifest del progetto Apps Script. Assicurati che il file manifest nel tuo progetto Apps Script contenga una sezione addOns e una sezione meet. Le sezioni addOns e meet seguono la stessa struttura descritta nella scheda Deployment HTTP.

   A differenza di altri componenti aggiuntivi di Google Workspace, i componenti aggiuntivi di Meet non possono essere creati interamente in Apps Script. Devi invece creare un'app web completa creando un riquadro laterale e un palco principale. L'URL del riquadro laterale della tua app web deve essere specificato nella sezione SIDE_PANEL_URI del file manifest appsscript.json.

Installare e testare il componente aggiuntivo in Meet

Per testare il componente aggiuntivo in Meet, devi prima installarlo per l'utente che ha eseguito l'accesso:

Deployment HTTP

1. Vai all'SDK di Google Workspace Marketplace per il tuo progetto nella console Google Cloud.
2. Fai clic sulla scheda Deployment HTTP.
3. Fai clic su Installa nella colonna Azioni.

Google Apps Script

1. Segui la documentazione del componente aggiuntivo di Google Workspace per installare un componente aggiuntivo non pubblicato.

Ora dovresti essere in grado di utilizzare il componente aggiuntivo in una riunione. Per provarlo, avvia una riunione su meet.google.com. Il componente aggiuntivo installato è ora visibile nel riquadro Attività.

Oltre a installare il componente aggiuntivo per il singolo utente che ha eseguito l'accesso, puoi anche pubblicarlo. Quando pubblichi il componente aggiuntivo Google Workspace, lo rendi disponibile per consentire ad altri di trovarlo, installarlo e utilizzarlo.