Creare un componente aggiuntivo di Meet

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

Creare 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 Google Workspace Marketplace e l'API Google Workspace Add-ons sono necessari per sviluppare componenti aggiuntivi di Meet. Per attivarle:

  1. Apri la console Google Cloud.
  2. In alto, se è già aperto un altro progetto, seleziona il nome di quello 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 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 di quello dell'app per cambiare progetto.
  3. Fai clic su API e servizi.
  4. Seleziona Google Workspace Marketplace SDK per visualizzare la pagina dei dettagli.

  5. Opzione A: utilizzo di un deployment di runtime alternativo.

    1. Fai clic sulla scheda Runtime alternativi.

    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 di componenti aggiuntivi a identificare il deployment contenente il manifest del componente aggiuntivo. Gli ID deployment sono obbligatori e possono contenere al massimo 100 caratteri.

    3. Tocca Next (Avanti).

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

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

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

      Sostituisci quanto segue:

      • NAME: stringa. Il nome del tuo componente componente aggiuntivo Google Meet.
      • LOGO_URL: stringa. L'URL del logo del componente componente aggiuntivo Meet.
      • SIDE_PANEL_URI: stringa. L'URL dell'iframe 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 succede in una sessione collaborativa dei componenti aggiuntivi. Se viene impostato su true, chi ha avviato la sessione collaborativa del componente aggiuntivo può condividere lo schermo con la visualizzazione del componente aggiuntivo.
      • MEET_WEB_LOGO_URL: facoltativo. Stringa. Un URL del logo specifico per Meet del componente aggiuntivo.
      • ADD_ON_ORIGINS: elenco di stringhe. Un elenco di origini utilizzate dal componente aggiuntivo. Due URL hanno la stessa origine quando condividono lo stesso schema, host e porta. Sono consentite anche le origini secondarie. Per maggiori informazioni, consulta Sicurezza dei componenti aggiuntivi.

    4. Fai clic su Invia.

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

    5. (Facoltativo) A scopo di test, l'utente che ha eseguito l'accesso può installare il componente aggiuntivo facendo clic su Installa nella colonna Azioni.

    6. Nella scheda Configurazione app, in Integrazione app, seleziona Componente aggiuntivo Google Workspace. Seleziona Esegui il deployment utilizzando la risorsa di deployment cloud, quindi scegli il deployment del runtime alternativo corretto.

    Opzione B: utilizzare un'implementazione di Google Apps Script.

    1. Fai clic sulla scheda Configurazione app.

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

    3. Fai clic su Salva.

      Per maggiori dettagli su come creare un progetto Apps Script, consulta la documentazione di Apps Script. Non è necessario scrivere codice Apps Script. Il componente aggiuntivo di Meet si basa esclusivamente sul file "appsscript.json", chiamato anche file manifest. Assicurati che il file manifest del tuo progetto Apps Script contenga una sezione addOns e una meet. Le sezioni addOns e meet seguono la stessa struttura descritta in "Opzione A".

Pubblica il componente aggiuntivo

Se vuoi che altri utenti possano installare il componente aggiuntivo o se vuoi testare il flusso delle voci di condivisione dello schermo, il componente aggiuntivo deve essere pubblicato. Un componente aggiuntivo può essere pubblicato in privato (accessibile solo nel tuo dominio) o pubblicamente. Tieni presente che anche quando il componente aggiuntivo viene pubblicato, puoi decidere se gli utenti possono trovarlo utilizzando Google Workspace Marketplace o tramite un link diretto.

Per ulteriori informazioni, consulta queste istruzioni su come pubblicare un componente aggiuntivo.

Apri il componente aggiuntivo in Meet

Crea una riunione all'indirizzo meet.google.com. Il componente aggiuntivo installato è ora visibile nel riquadro Componenti aggiuntivi.