Best practice

Migliora l'esperienza complessiva dei tuoi utenti seguendo queste guide per il design dei componenti aggiuntivi di Google Meet.

Best practice per l'autorizzazione

Ti invitiamo a utilizzare le seguenti best practice per tutti i componenti aggiuntivi di Google Meet che richiedono autenticazione o autorizzazione.

Utilizzare Accedi con Google

Molti utenti dei componenti aggiuntivi di Google Workspace avranno già eseguito l'accesso a Google prima di partecipare alla riunione. Pertanto, avere Google One Tap come opzione può far risparmiare agli utenti diversi clic durante il flusso di accesso. Per ulteriori informazioni, vedi Gestire i metodi di accesso per il componente aggiuntivo.

Aprire la pagina di accesso di terze parti in una nuova finestra

Oltre all'accesso con Google, la tua applicazione potrebbe offrire meccanismi di accesso aggiuntivi. In questo caso, utilizza una finestra di dialogo anziché aprire una pagina di accesso in una nuova scheda. In questo modo, l'utente può comunque vedere e tornare alla chiamata di Meet ed eseguire meno clic complessivi.

Richiedi correttamente gli ambiti per le API di Google

Se il componente aggiuntivo di Meet chiama le API di Google, devi fornire un elenco completo degli ambiti OAuth richiesti dal componente aggiuntivo. Questa operazione viene eseguita nella pagina Configurazione app di Google Workspace Marketplace. Dopo aver aggiunto questi ambito, agli utenti viene mostrata una richiesta al momento dell'installazione del componente aggiuntivo Meet che indica il tipo di dati a cui l'app può accedere.

Prima di pubblicare il componente aggiuntivo, devi anche configurare la schermata per il consenso OAuth. Ciò richiede l'aggiunta esatta degli stessi ambiti di autorizzazione dalla configurazione dell'app Google Workspace Marketplace. La configurazione della schermata per il consenso OAuth richiede anche l'impostazione delle informazioni sul branding, delle norme sulla privacy e dei Termini di servizio che vengono visualizzati quando vengono richiesti gli ambiti. Per la pubblicazione pubblica, tutte queste informazioni devono essere inviate per la verifica.

Quando scrivi il codice per chiamare le API Google Workspace, il modo più semplice per iniziare è seguire la guida rapida a JavaScript. Questo approccio rispetta le best practice per l'utilizzo di Accedi con Google e delle finestre di dialogo. Tieni presente che per iniziare l'inizializzazione del client token in JavaScript è necessario richiedere separatamente gli ambiti effettivamente utilizzati dall'applicazione in fase di runtime. Per una migliore esperienza utente, questi ambiti richiesti devono corrispondere a quelli indicati nella pagina Configurazione app di Google Workspace Marketplace. Questa ridondanza fornisce un piano di riserva per gestire il caso in cui un utente abbia revocato gli ambiti.

Best practice per la manutenzione

Le seguenti best practice riguardano la scrittura di applicazioni web gestibili, ma sono particolarmente importanti quando si scrivono componenti aggiuntivi di Meet.

Utilizzare la versione più recente dell'SDK di Google Meet Add-ons

L'SDK di Meet Add-ons viene aggiornato regolarmente. L'SDK è conforme al versionamento semantico. Per trovare la versione più recente:

  • Quando utilizzi gstatic: la versione più recente dell'SDK è contenuta nell'URL gstatic riportato nelle istruzioni per l'utilizzo dell'SDK.
  • Quando utilizzi npm: esegui npm update @googleworkspace/meet-add-ons dalla directory contenente il file package.json per il sito web che ospita il tuo componente aggiuntivo Meet.

Creare un progetto Google Cloud temporaneo

Una volta pubblicato il componente aggiuntivo Google Meet su Google Workspace Marketplace, tutti i nuovi implementazioni del componente aggiuntivo Google Meet sono immediatamente disponibili per gli utenti di Meet. Gli utenti vedranno questi aggiornamenti non appena svuotano la cache o quando questa scade. Pertanto, ti consigliamo di non spingere le modifiche al sito di produzione finché non sono state testate a fondo.

Per evitare di eseguire il deployment direttamente in produzione, ti consigliamo di creare un progetto Google Cloud distinto pubblicato privatamente per la tua organizzazione. Questo progetto cloud ospiterà sia gli ambienti di staging sia quelli di sviluppo per il tuo componente aggiuntivo Meet. L'accesso a questo progetto cloud deve essere limitato a un team più piccolo che si occupa direttamente dello sviluppo del componente aggiuntivo.

Per creare questi ambienti alternativi per il tuo componente aggiuntivo, devi prima ospitare gli ambienti alternativi della tua applicazione web che contiene il componente aggiuntivo su un dominio di tua proprietà. Quindi, puoi creare ambienti alternativi per il tuo plug-in Meet aggiungendo ulteriori implementazioni al tuo progetto Google Cloud di staging. Questi nuovi deployment dovrebbero contenere manifest che rimandano agli ambienti alternativi della tua applicazione web. Quindi, ti consigliamo di installare ogni ambiente aggiuntivo come segue:

  • Staging: pubblica privatamente la versione temporanea in modo che chiunque nella tua organizzazione possa aiutarti con i test.
  • Sviluppo: fai clic su Installa nella colonna Azioni per installare la versione di sviluppo del componente aggiuntivo Meet solo sul tuo account.

Scrivere i test

Prima di eseguire il deployment del componente aggiuntivo Meet in un ambiente di sviluppo, ti consigliamo di scrivere i test delle unità. I test di unità devono includere:

  • Simulazione dell'SDK di Meet Add-on e verifica che il plug-in di Meet chiami le funzioni dell'SDK come previsto.
  • Test delle unità di tutte le funzionalità non correlate all'SDK del componente aggiuntivo con il framework di test web che preferisci.

Best practice per l'esperienza utente

Le seguenti best practice ti aiutano a rendere un componente aggiuntivo di Meet più intuitivo e raffinato.

Gestisci tutto lo stato iniziale nel riquadro laterale

Ti consigliamo vivamente di configurare il componente aggiuntivo in base alle azioni degli utenti intraprese nel riquadro laterale. A questo scopo, imposta lo stato di avvio dell'attività in JavaScript. Tutti i dati inseriti in ActivityStartingState devono essere impostati dall'iniziatore del componente aggiuntivo (in genere l'organizzatore della riunione) all'interno del riquadro laterale. Puoi considerare la prima visualizzazione del riquadro laterale come un modulo che controlla la configurazione del componente aggiuntivo.

Chiudere il riquadro laterale quando non è in uso

Dopo aver avviato l'attività chiamando il metodo startActivity(), tieni aperto il riquadro laterale solo se è una parte essenziale dell'esperienza utente per il componente aggiuntivo di Google Meet. Puoi chiudere il riquadro laterale dopo aver aperto il livello principale chiamando il metodo unloadSidePanel().

Promuovere il tuo componente aggiuntivo di Meet tramite la condivisione dello schermo

I componenti aggiuntivi di Meet offrono un'esperienza più completa rispetto alla condivisione schermo. Tuttavia, molti utenti sono abituati a utilizzare la funzionalità di condivisione schermo di Meet. Se un utente condivide una scheda che mostra il sito web che ospita il tuo plug-in Meet, Meet può essere configurato in modo da mostrare un banner a tutti i partecipanti alla chiamata chiedendo di installare o utilizzare il plug-in Meet corrispondente. Per ulteriori informazioni, consulta la sezione sulla promozione del componente aggiuntivo tramite la condivisione schermo.

Linee guida per il design del logo

Segui queste linee guida quando progetti il tuo logo specifico per Meet per avere un aspetto ottimale ora e in futuro:

Utilizza il formato file PNG, con dimensioni di 256 x 256 px.

Utilizza la trasparenza.

Verifica che il tuo logo sia adatto alla modalità Buio utilizzando gli strumenti per sviluppatori per i componenti aggiuntivi di Meet.

Rispettare i requisiti grafici per integrazioni di app specifiche.

Non includere spaziature interne nell'immagine. Estendi l'immagine fino ai confini del file.