Se hai già creato e pubblicato un componente aggiuntivo per estendere Gmail o Calendar, puoi eseguire l'upgrade in un componente aggiuntivo di Google Workspace. Le istruzioni riportate in questa pagina descrivono in dettaglio come aggiungere le funzionalità di Google Workspace ai componenti aggiuntivi di Gmail o Calendar esistenti e poi pubblicare il componente aggiuntivo di cui è stato eseguito l'upgrade 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 inoltre di sfruttare le nuove funzionalità dei componenti aggiuntivi di Google Workspace, come le home page.
Passaggio 1: crea una copia del progetto Apps Script del tuo componente aggiuntivo
Il componente aggiuntivo di cui è stato eseguito l'upgrade 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 siano interessati durante il test della versione di cui è stato eseguito l'upgrade. L'upgrade di una copia del progetto di script originale significa anche che puoi sempre accedere al codice originale e ridistribuirlo in un secondo momento, se necessario.
- Apri il progetto Apps Script del componente aggiuntivo di Gmail o del componente aggiuntivo per le conferenze di Calendar.
- 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 aggiuntivo pubblicato esistente.
- Fai clic su Imposta progetto.
Passaggio 2: integra il componente aggiuntivo di Google Workspace
Devi progettare e implementare le funzionalità dei componenti aggiuntivi di Google Workspace che vuoi aggiungere al tuo componente aggiuntivo.
- Pianifica quali contenuti mostrare nelle schede della home page del tuo componente aggiuntivo e se devono essere visualizzati in Gmail, Calendar, Drive o in 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 eventuali funzioni o logiche 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 un thread di messaggi di Gmail o di un evento di Calendar.
Aggiorna qualsiasi accesso agli oggetti evento nel tuo componente aggiuntivo (nelle funzioni di callback dei widget o nelle funzioni di trigger contestuali) per utilizzare la struttura dell'oggetto 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 stati ritirati e verranno rimossi definitivamente.
Passaggio 3: aggiorna il file manifest del componente aggiuntivo
Il modo in cui le informazioni di configurazione vengono memorizzate nella
struttura manifest dei plug-in di Google Workspace è cambiato notevolmente rispetto alla struttura utilizzata dai plug-in di Gmail
e dai plug-in per le conferenze di Calendar. Durante 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 proprietà secondarie pertinenti alla nuova proprietà
addOns.
Assicurati di aggiornare anche il campo oauthScopes del manifest in base alle autorizzazioni richieste dal componente aggiuntivo aggiornato.
Per scoprire di più sui manifest dei componenti aggiuntivi di Google Workspace, consulta Manifest.
Componenti aggiuntivi di Gmail
| Campo manifest originale | Azione richiesta |
|---|---|
gmail.composeTrigger |
Vai a addOns.gmail.composeTrigger. |
gmail.contextualTriggers[] |
Sposta l'elenco in addOns.gmail.contextualTriggers[]. |
gmail.logoUrl |
Vai a addOns.common.logoUrl. |
gmail.name |
Vai a addOns.common.name. |
gmail.openLinkUrlPrefixes[] |
Sposta l'elenco in addOns.common.openLinkUrlPrefixes[].
|
gmail.primaryColor |
Vai a addOns.common.layoutProperties.primaryColor. |
gmail.secondaryColor |
Vai a addOns.common.layoutProperties.secondaryColor.
|
gmail.universalActions[] |
Sposta l'elenco in addOns.common.universalActions[]. |
gmail.universalActions[].text |
Sposta ogni campo gmail.universalActions[].text in un corrispondente campo addOns.common.universalActions[].label. |
gmail.useLocalFromApp |
Vai a addOns.common.useLocaleFromApp. |
Componenti aggiuntivi per le conferenze di Calendar
| Campo manifest originale | Azione richiesta |
|---|---|
calendar.createSettingsUrlFunction |
Vai a addOns.calendar.createSettingsUrlFunction. |
calendar.conferenceSolution[] |
Vai a addOns.calendar.conferenceSolution[]. |
calendar.logoUrl |
Vai a addOns.common.logoUrl. |
calendar.name |
Vai a addOns.common.name. |
Passaggio 4: testa il componente aggiuntivo di cui è stato eseguito l'upgrade
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 recensioni del componente aggiuntivo di cui è stato 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.
Per inviare il tuo componente aggiuntivo per la revisione:
Assicurati che il tuo componente aggiuntivo soddisfi tutti i requisiti di pubblicazione dei componenti aggiuntivi.
Crea un deployment con versione del tuo componente aggiuntivo di Google Workspace (nel nuovo progetto Apps Script) utilizzando la versione del codice che vuoi pubblicare. Non tentare di pubblicare utilizzando un deployment iniziale.
Se hai aggiunto nuovi ambiti durante l'upgrade del componente aggiuntivo, devi richiedere la verifica OAuth. Ad esempio, se il componente aggiuntivo di Gmail utilizza nuovi ambiti di Drive o Calendar nella versione del componente aggiuntivo di Google Workspace, devi inviare questi nuovi ambiti per la verifica. La verifica spesso richiede alcuni giorni, quindi avvia la procedura il prima possibile. Assicurati che il componente aggiuntivo sia verificato prima di procedere al passaggio 6.
Passaggio 6: rendi disponibile il componente aggiuntivo di cui è stato eseguito l'upgrade
Apri l'SDK di Google Workspace Marketplace.
A sinistra, fai clic su Configurazione. Questo riquadro contiene un modulo in cui fornire informazioni sul componente aggiuntivo.
Aggiorna la descrizione breve, la descrizione dettagliata e gli screenshot della 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 Google Workspace. Nella casella di testo visualizzata, inserisci il nuovo ID di implementazione che hai creato per il tuo componente aggiuntivo Google Workspace nel passaggio precedente. Se l'ID di implementazione è valido, viene visualizzato un elenco di host supportati.
Se hai aggiunto nuovi ambiti al componente aggiuntivo di Google Workspace, assicurati di aggiungerli alla sezione Ambiti OAuth 2.0 nella pagina Configurazione. Gli ambiti elencati in quella sezione devono corrispondere esattamente agli ambiti elencati nel manifest del tuo componente aggiuntivo.
Verifica che le informazioni inserite nel modulo siano corrette. Poi, fai clic su Salva modifiche.
Se hai domande o riscontri un problema durante la procedura di upgrade del componente aggiuntivo Google Workspace, contattaci.
Domande frequenti
Di seguito sono riportate le domande frequenti sugli upgrade dei componenti aggiuntivi:
Posso eseguire l'upgrade del mio componente aggiuntivo Editor?
La maggior parte dei componenti aggiuntivi di Editor può essere spostata nei componenti aggiuntivi di Google Workspace. Tuttavia, non è possibile eseguire l'upgrade 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 di Editor a un componente aggiuntivo di Google Workspace, devi riscriverne l'interfaccia utente da HTML a un'interfaccia basata su schede e aggiornare la gestione di JavaScript al servizio Card.
Alcuni servizi del tuo componente aggiuntivo Editor esistente potrebbero non essere disponibili nel servizio Schede. Ad esempio, se il tuo componente aggiuntivo Editor include un selettore di file, non è disponibile un equivalente nel servizio Schede per i componenti aggiuntivi di Google Workspace.
Posso creare un componente aggiuntivo di Google Workspace separato e mantenere quello esistente?
Puoi creare altri componenti aggiuntivi di Google Workspace con nomi di brand diversi, ma non sono consentiti componenti aggiuntivi per conferenze di Gmail o Calendar separati con lo stesso nome del brand del tuo componente aggiuntivo di Google Workspace. Se hai domande o vuoi richiedere un'eccezione, contattaci.
I miei utenti dovranno autorizzare di nuovo il componente aggiuntivo dopo l'upgrade?
Se il componente aggiuntivo di Google Workspace utilizza lo stesso progetto della piattaforma Cloud (Google Cloud) di base, con un ID client OAuth associato, gli utenti non dovranno riavviare l'autorizzazione delle autorizzazioni che hanno precedentemente autorizzato per il componente aggiuntivo originale. Tuttavia, se aggiunti nuovi ambiti durante la procedura di upgrade, gli utenti devono autorizzarli la prima volta che utilizzano la versione del componente aggiuntivo per Google Workspace.
Posso eseguire l'upgrade della mia estensione di 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 di Chrome al marketplace Google Workspace.
Posso raggruppare più componenti aggiuntivi con il mio componente aggiuntivo di Google Workspace?
Consulta Elencare insieme le integrazioni di app.