Eseguire il deployment di un componente aggiuntivo di Meet

I componenti aggiuntivi di Google Meet vengono creati e configurati come parte di un progetto Google Cloud.

Crea un progetto Google Cloud

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

Attiva l'SDK di Google Workspace Marketplace e l'API dei componenti aggiuntivi di Google Workspace

L'SDK di Marketplace e l'API dei componenti aggiuntivi di Google Workspace sono necessari 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 dell'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.

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

Crea un deployment

Per utilizzare un componente aggiuntivo in Meet, sono necessari un deployment e 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 dell'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 (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. Questo file è 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": {
            "sidePanelUrl": "SIDE_PANEL_URL",
            "supportsScreenSharing": SUPPORTS_SCREENSHARING,
            "addOnOrigins": ["ADD_ON_ORIGINS"],
            "logoUrl": "MEET_WEB_LOGO_URL",
            "darkModeLogoUrl": "DARK_MODE_LOGO_URL"
          }
        }
      }
    }
    

    Sostituisci quanto segue:

    • NAME: stringa. Il nome del componente aggiuntivo di Google Meet.
    • LOGO_URL: stringa. L'URL del logo del componente aggiuntivo di Google Workspace. Questo logo viene utilizzato per il componente aggiuntivo nei prodotti Google Workspace.
    • SIDE_PANEL_URL: stringa. L'URL del punto di ingresso dell'app del componente aggiuntivo. 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.
    • SUPPORTS_SCREENSHARING: facoltativo. Booleano. Se impostato su false, gli utenti devono utilizzare il componente aggiuntivo per vedere cosa sta succedendo in una sessione di componenti aggiuntivi collaborativi. Se impostato su true, l'utente che avvia la sessione di componenti aggiuntivi collaborativi può condividere lo schermo della sua visualizzazione del componente aggiuntivo.
    • ADD_ON_ORIGINS: elenco di stringhe. Un elenco di origini in cui è ospitato il 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, consulta Sicurezza dei componenti aggiuntivi.
    • 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 il logoUrl della sezione comune. Per le linee guida sulla progettazione dei loghi, consulta Best practice.
    • DARK_MODE_LOGO_URL: stringa. Un URL specifico della modalità Buio del logo del componente aggiuntivo. Se fornisci un logo in modalità Buio, il componente aggiuntivo avrà un aspetto ottimale in qualsiasi tema di Meet. Per le linee guida sulla progettazione dei loghi, consulta Best practice.
  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 di 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 di 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 sezione meet.

    Il seguente esempio di codice mostra i campi di Meet disponibili nel file manifest del componente aggiuntivo.

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

    Sostituisci quanto segue:

    • NAME: stringa. Il nome del componente aggiuntivo di Google Meet.
    • LOGO_URL: stringa. L'URL del logo del componente aggiuntivo di Google Workspace. Questo logo viene utilizzato per il componente aggiuntivo nei prodotti Google Workspace.
    • SIDE_PANEL_URL: stringa. L'URL del punto di ingresso dell'app del componente aggiuntivo. 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.
    • SUPPORTS_SCREENSHARING: facoltativo. Booleano. Se impostato su false, gli utenti devono utilizzare il componente aggiuntivo per vedere cosa sta succedendo in una sessione di componenti aggiuntivi collaborativi. Se impostato su true, l'utente che avvia la sessione di componenti aggiuntivi collaborativi può condividere lo schermo della sua visualizzazione del componente aggiuntivo.
    • ADD_ON_ORIGINS: elenco di stringhe. Un elenco di origini in cui è ospitato il 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, consulta Sicurezza dei componenti aggiuntivi.
    • 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 il logoUrl della sezione comune. Per le linee guida sulla progettazione dei loghi, consulta Best practice.
    • DARK_MODE_LOGO_URL: stringa. Un URL specifico della modalità Buio del logo del componente aggiuntivo. Se fornisci un logo in modalità Buio, il componente aggiuntivo avrà un aspetto ottimale in qualsiasi tema di Meet. Per le linee guida sulla progettazione dei loghi, consulta Best practice.

Installa e testa 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. Accedi 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 dei componenti aggiuntivi 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 componente aggiuntivo di Google Workspace, lo rendi disponibile per altri utenti che possono trovarlo, installarlo e utilizzarlo.