Se hai già creato e pubblicato un componente aggiuntivo per estendere Gmail o Calendar, puoi eseguire l'upgrade a un componente aggiuntivo Google Workspace. Le istruzioni riportate in questa pagina descrivono in dettaglio come aggiungere la funzionalità Google Workspace ai componenti aggiuntivi Gmail o Calendar esistenti e poi pubblicare il componente aggiuntivo aggiornato in modo che possa essere rilevato e installato.
Puoi trasferire la nuova funzionalità nel componente aggiuntivo originale per conservare la scheda, le installazioni e gli utenti di Google Workspace Marketplace. L'upgrade ti consente anche di sfruttare le nuove funzionalità del componente aggiuntivo di Google Workspace, ad esempio le home page.
Passaggio 1: crea una copia del progetto Apps Script del componente aggiuntivo
Il componente aggiuntivo aggiornato utilizza lo stesso progetto Google Cloud del componente aggiuntivo pubblicato, ma è importante creare e utilizzare una copia del progetto Apps Script sottostante in modo che gli utenti esistenti non vengano interessati durante il test della versione aggiornata. L'upgrade di una copia del progetto di script originale significa anche che puoi sempre accedere al codice originale e puoi eseguirne nuovamente il deployment in un secondo momento, se necessario.
- Apri il progetto Apps Script del componente aggiuntivo Gmail o del componente aggiuntivo per le conferenze di Calendar esistente.
- A sinistra, fai clic su Panoramica .
- A destra, fai clic su Crea una copia .
- A sinistra, fai clic su Impostazioni progetto > Cambia progetto.
- Fai clic su Numero progetto Google Cloud.
- Inserisci lo stesso numero di progetto associato al tuo progetto Apps Script del componente aggiuntivo pubblicato esistente.
- Fai clic su Imposta progetto.
Passaggio 2: integra il componente aggiuntivo di Google Workspace
Devi progettare e implementare tutte le funzionalità dei componenti aggiuntivi di Google Workspace che vuoi aggiungere al tuo componente aggiuntivo.
- Pianifica i contenuti da mostrare nelle schede della home page del tuo componente aggiuntivo e se devono essere visualizzati in Gmail, Calendar, Drive o in una qualsiasi combinazione dei tre host. Se vuoi una home page in più di un host, decidi se può essere la stessa home page o se vuoi schede della home page personalizzate per ogni host.
- Nel progetto Apps Script del componente aggiuntivo copiato, crea le schede della home page
con le funzioni
homepageTrigger. Assicurati di includere tutte le funzioni o la logica di supporto necessarie per controllare le nuove interfacce della home page. Valuta la possibilità di aggiungere schede contestuali attivate dall'azione di un utente, ad esempio l'apertura di una thread di messaggi di Gmail o di un evento di Calendar.
Aggiorna l'accesso agli oggetti evento nel componente aggiuntivo (nelle funzioni di callback dei widget o nelle funzioni di attivazione contestuale) per utilizzare la struttura degli oggetti evento aggiornata. La nuova struttura contiene ancora gli stessi campi dell'oggetto evento utilizzati dai componenti aggiuntivi per le conferenze di Gmail e Calendar, ma questi campi originali sono ritirati e verranno rimossi.
Passaggio 3: aggiorna il manifest del componente aggiuntivo
Il modo in cui le informazioni di configurazione vengono archiviate nella struttura del manifest dei componenti aggiuntivi di Google Workspace è cambiato notevolmente rispetto alla struttura utilizzata dai componenti aggiuntivi di Gmail e di videoconferenza di Calendar. Quando esegui l'upgrade del componente aggiuntivo, devi aggiornare i campi manifest del progetto Apps Script del componente aggiuntivo
in base alle tabelle riportate di seguito. Devi aggiornare tutte le sottoproprietà pertinenti alla nuova proprietà
addOns.
Assicurati di aggiornare anche il campo
oauthScopes del manifest
in base alle necessità per riflettere le autorizzazioni richieste dal componente aggiuntivo aggiornato.
Per scoprire di più sui manifest dei componenti aggiuntivi di Google Workspace, consulta la sezione Manifest.
Componenti aggiuntivi di Gmail
| Campo Manifest originale | Azione richiesta |
|---|---|
gmail.composeTrigger |
Sposta in addOns.gmail.composeTrigger. |
gmail.contextualTriggers[] |
Sposta l'elenco su addOns.gmail.contextualTriggers[]. |
gmail.logoUrl |
Sposta in addOns.common.logoUrl. |
gmail.name |
Sposta in addOns.common.name. |
gmail.openLinkUrlPrefixes[] |
Sposta l'elenco su addOns.common.openLinkUrlPrefixes[].
|
gmail.primaryColor |
Sposta in addOns.common.layoutProperties.primaryColor. |
gmail.secondaryColor |
Sposta in addOns.common.layoutProperties.secondaryColor.
|
gmail.universalActions[] |
Sposta l'elenco su addOns.common.universalActions[]. |
gmail.universalActions[].text |
Sposta ogni campo gmail.universalActions[].text in un campo addOns.common.universalActions[].label corrispondente. |
gmail.useLocalFromApp |
Sposta in addOns.common.useLocaleFromApp. |
Componenti aggiuntivi per le conferenze di Calendar
| Campo Manifest originale | Azione richiesta |
|---|---|
calendar.createSettingsUrlFunction |
Sposta in addOns.calendar.createSettingsUrlFunction. |
calendar.conferenceSolution[] |
Sposta in addOns.calendar.conferenceSolution[]. |
calendar.logoUrl |
Sposta in addOns.common.logoUrl. |
calendar.name |
Sposta in addOns.common.name. |
Passaggio 4: testa il componente aggiuntivo aggiornato
Per testare il componente aggiuntivo di cui è stato eseguito l'upgrade prima della pubblicazione, consulta Testare i componenti aggiuntivi di Google Workspace.
Passaggio 5: richiedi revisioni del componente aggiuntivo di cui hai eseguito l'upgrade
Tutti i componenti aggiuntivi di Google Workspace, che si tratti di un componente aggiuntivo di cui è stato eseguito l'upgrade o di uno creato da zero, devono essere approvati prima di poter essere elencati in Google Workspace Marketplace.
Segui questi passaggi per inviare il componente aggiuntivo per la revisione:
Assicurati che il tuo componente aggiuntivo soddisfi tutti i requisiti di pubblicazione dei componenti aggiuntivi.
Crea un deployment con controllo delle versioni del componente aggiuntivo di Google Workspace (nel nuovo progetto Apps Script) utilizzando la versione del codice che vuoi pubblicare. Non tentare di pubblicare utilizzando una distribuzione principale.
Se hai aggiunto nuovi ambiti durante l'upgrade del componente aggiuntivo, devi richiedere la verifica OAuth. Ad esempio, se il tuo componente aggiuntivo Gmail utilizza nuovi ambiti Drive o Calendar nella versione del componente aggiuntivo Google Workspace, devi inviare questi nuovi ambiti per la verifica. La verifica richiede spesso alcuni giorni, quindi avvia la procedura il prima possibile. Prima di procedere al passaggio 6, assicurati che il componente aggiuntivo sia verificato.
Passaggio 6: rendi disponibile il componente aggiuntivo aggiornato
Apri l'SDK di Google Workspace Marketplace.
A sinistra, fai clic su Configurazione. Questo riquadro contiene un modulo in cui fornisci informazioni sul tuo componente aggiuntivo.
Aggiorna la descrizione breve, la descrizione dettagliata e gli screenshot della tua scheda in modo che riflettano la nuova funzionalità del componente aggiuntivo di Google Workspace.
In Estensioni, fai clic sul pulsante Esegui l'upgrade al componente aggiuntivo di Google Workspace. Nella casella di testo visualizzata, inserisci il nuovo ID deployment che hai creato per il tuo componente aggiuntivo di Google Workspace nel passaggio precedente. Se l'ID deployment è valido, viene visualizzato un elenco di host supportati.
Se hai aggiunto nuovi ambiti al tuo componente aggiuntivo Google Workspace, assicurati di aggiungerli alla sezione Ambiti OAuth 2.0 nella pagina Configurazione. Gli ambiti elencati in questa sezione devono corrispondere esattamente a quelli elencati nel manifest dell'add-on.
Verifica che le informazioni inserite nel modulo siano corrette. Poi, fai clic su Salva modifiche.
Se hai domande o riscontri un problema durante questo processo di upgrade del componente aggiuntivo Google Workspace, contattaci.
Domande frequenti
Di seguito sono riportate le domande frequenti relative agli upgrade dei componenti aggiuntivi:
Posso eseguire l'upgrade del mio componente aggiuntivo Editor?
La maggior parte dei componenti aggiuntivi dell'editor può essere spostata nei componenti aggiuntivi di Google Workspace. Tuttavia, non possono essere aggiornati ai componenti aggiuntivi di Google Workspace con la stessa facilità dei componenti aggiuntivi per Gmail e Calendar.
Se vuoi eseguire la migrazione del componente aggiuntivo Editor a un componente aggiuntivo di Google Workspace, devi riscrivere l'interfaccia utente del componente aggiuntivo da HTML a un'interfaccia basata su schede e aggiornare la gestione JavaScript al servizio schede.
Alcuni servizi nel componente aggiuntivo Editor esistente potrebbero non essere disponibili nel servizio di schede. Ad esempio, se il componente aggiuntivo Editor include un selettore di file, non esiste un equivalente disponibile dal servizio di schede per i componenti aggiuntivi Google Workspace.
Posso creare un componente aggiuntivo di Google Workspace separato e mantenere il mio componente aggiuntivo esistente?
Puoi creare altri componenti aggiuntivi di Google Workspace con nomi di brand diversi, ma non consentiamo componenti aggiuntivi separati per conferenze di Gmail o Calendar con lo stesso nome di brand del tuo componente aggiuntivo di Google Workspace. Se hai domande o vuoi richiedere un'eccezione, contattaci.
I miei utenti dovranno autorizzare nuovamente il componente aggiuntivo dopo l'upgrade?
Se il componente aggiuntivo di Google Workspace utilizza lo stesso progetto Google Cloud (GCP) sottostante, con un ID client OAuth associato, gli utenti non dovranno riautorizzare le autorizzazioni che hanno precedentemente autorizzato per il componente aggiuntivo originale. Tuttavia, se aggiungi nuovi ambiti durante la procedura di upgrade, i tuoi utenti devono autorizzare questi nuovi ambiti la prima volta che utilizzano la versione Google Workspace del tuo componente aggiuntivo.
Posso eseguire l'upgrade della mia estensione Chrome a un componente aggiuntivo di Google Workspace e trasferire gli utenti?
No. Non puoi trasferire gli utenti, le installazioni e le recensioni della scheda di un'estensione di Chrome. Devi creare un nuovo componente aggiuntivo Google Workspace e indirizzare gli utenti della tua estensione Chrome a Google Workspace Marketplace.
Posso raggruppare più componenti aggiuntivi con il mio componente aggiuntivo Google Workspace?
Vedi Elencare insieme le integrazioni di app.