Questa pagina è stata tradotta dall'API Cloud Translation.

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.

Creare un progetto Google Cloud

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

Attiva l'SDK Google Workspace Marketplace e l'API Google Workspace Add-ons

L'SDK di Google Workspace Marketplace e l'API Componenti aggiuntivi di Google Workspace sono obbligatori per sviluppare i componenti aggiuntivi di Meet. Per attivarle:

Apri l'app Google Cloud Google Cloud.
In alto, se è già aperto un altro progetto, seleziona il nome del progetto della tua app per passare da un progetto all'altro.
In alto, nella barra di ricerca, digita Google Workspace Marketplace SDK e premi Invio.
Apri la pagina Google Workspace Marketplace SDK e fai clic su Abilita.

Avviso: assicurati di attivare Google Workspace Marketplace SDK, non il tramite Google Cloud CLI o tramite l'API Compute Engine. Google Workspace Marketplace API è uno strumento diverso utilizzato per integrarsi con i servizi di licenze e fatturazione di Google.
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

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

Crea il tuo deployment

Puoi creare il tuo deployment direttamente nella console Google Cloud creando un Deployment HTTP (consigliato) oppure mediante Google Apps Script.

Deployment HTTP

Fai clic sulla scheda Deployment HTTP.
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. Deployment Gli ID sono obbligatori e possono contenere al massimo 100 caratteri.
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 dei componenti aggiuntivi è il file configurazione centralizzata per 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 per il il 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. La origin di questo URL deve essere parte delle origini specificate ADD_ON_ORIGINS.
- ADD_ON_ORIGINS: elenco di stringhe. Un elenco di origins in cui in hosting sul componente aggiuntivo. Due URL hanno lo stesso quando condividono lo stesso schema, lo stesso host e la stessa porta. Sono consentite anche le origini secondarie, così come i sottodomini con caratteri jolly. Per ulteriori informazioni, vedi Sicurezza aggiuntiva.
- DARK_MODE_LOGO_URL: stringa. Scuro l'URL specifico della modalità del logo per il componente aggiuntivo. Fornendo un logo per la modalità Buio avrai la certezza che il tuo componente aggiuntivo avrà un aspetto migliore su qualsiasi tema Meet. Per la progettazione del logo linee guida, consulta le best practice.
- MEET_WEB_LOGO_URL: facoltativo. Stringa. R L'URL del logo del componente aggiuntivo specifico per Meet. 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 aggiuntiva collaborativa la propria opinione sul componente aggiuntivo.
Fai clic su Invia.

Per ulteriori informazioni sui deployment, vedi Creare un delle risorse di deployment.
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

Fai clic sulla scheda Configurazione app.
In Integrazione app, seleziona Componente aggiuntivo di Google Workspace. Seleziona Deploy with Google Apps Script (Esegui il deployment con Google Apps Script) ID deployment e inserisci l'ID deployment dello script.
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 seguono le stesse come descritto 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 puoi creare un'app web creando un riquadro laterale e uno stage principale. L'URL del riquadro laterale dell'app web deve quindi essere specificato sotto il SIDE_PANEL_URI del file manifest appsscript.json.

Installare e testare il componente aggiuntivo in Meet

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

Deployment HTTP

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

Google Apps Script

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.