Eseguire il deployment di un componente aggiuntivo di Meet

I componenti aggiuntivi di Google Meet vengono creati e configurati all'interno di un progetto Google Cloud.

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 dei componenti aggiuntivi di Google Workspace

L'SDK di Google Workspace Marketplace e l'API Google Workspace Add-ons sono obbligatori per sviluppare i 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 della tua app per passare da un progetto all'altro.
  3. In alto, nella barra di ricerca, digita Google Workspace Marketplace SDK e premi Invio.
  4. Apri la pagina Google Workspace Marketplace SDK, fai clic su Attiva.

  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.

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

Crea il tuo deployment

Puoi creare il deployment direttamente nella console Google Cloud creando un deployment HTTP (opzione consigliata) 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 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 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. È anche chiamato 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 componente aggiuntivo Google Meet.
    • LOGO_URL: stringa. L'URL del logo del componente aggiuntivo di Google Workspace. Viene utilizzato per il componente aggiuntivo tra i prodotti Google Workspace.
    • SIDE_PANEL_URI: stringa. L'URL del punto di accesso della tua app di componenti aggiuntivi. 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 di origini in cui è ospitato il plug-in. 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, consulta Sicurezza dei componenti aggiuntivi.
    • DARK_MODE_LOGO_URL: stringa. Un URL specifico per la modalità scura del logo del componente aggiuntivo. Fornendo un logo in modalità Buio, il tuo componente aggiuntivo avrà un aspetto ottimale in qualsiasi tema di Meet. Per le linee guida sul design del logo, consulta le best practice.
    • MEET_WEB_LOGO_URL: facoltativo. Stringa. Un URL specifico di Meet del logo del componente aggiuntivo. Questo logo viene utilizzato in Meet. Se non è presente, viene utilizzato il valore logoUrl della sezione comune. Per le linee guida per la progettazione del logo, 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 la visualizzazione del componente aggiuntivo.
  4. Fai clic su Invia.

    Per ulteriori informazioni sui deployment, consulta 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 progetto Apps Script contenga una sezione addOns e una meet. Le sezioni addOns e meet hanno la stessa struttura descritta nella scheda di implementazione 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 una schermata principale. L'URL del riquadro laterale della tua app web deve essere specificato in 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 all'indirizzo 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 tuo componente aggiuntivo di Google Workspace, lo rendi disponibile per essere trovato, installato e utilizzato da altri.