Se hai già creato e pubblicato un componente aggiuntivo per estendere Gmail o Calendar, puoi eseguirne l'upgrade a un componente aggiuntivo di Google Workspace. Le istruzioni riportate in questa pagina spiegano come aggiungere la funzionalità di Google Workspace ai componenti aggiuntivi esistenti di Gmail o Calendar e come 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 di Google Workspace Marketplace, le installazioni e gli utenti. 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 per evitare che gli utenti esistenti subiscano modifiche durante il test della versione aggiornata. Inoltre, l'upgrade di una copia del progetto di script originale consente di accedere al codice originale e, se necessario, di rieseguire il deployment in un secondo momento.
- Apri il tuo componente aggiuntivo di Gmail o il progetto Apps Script del componente aggiuntivo per 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 progetto Apps Script esistente e pubblicato.
- 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 componente aggiuntivo.
- Pianifica quali contenuti mostrare nelle schede della home page del componente aggiuntivo e se devono essere visualizzati in Gmail, Calendar, Drive o in qualsiasi combinazione dei tre organizzatori. Se vuoi che una home page sia in più di un host, decidi se deve essere la stessa home page o se vuoi schede home page personalizzate per ogni host.
- Nel progetto Apps Script del componente aggiuntivo copiato, crea le schede della tua home page con le funzioni
homepageTrigger. Assicurati di includere le logiche o le funzioni di supporto necessarie per controllare le nuove interfacce della home page. Prendi in considerazione l'aggiunta di schede contestuali attivate dall'azione di un utente, come l'apertura di un thread di messaggi Gmail o un evento di Calendar.
Aggiorna qualsiasi accesso agli oggetti evento nel componente aggiuntivo (nelle funzioni di callback del widget o nelle funzioni trigger contestuali) per utilizzare la struttura degli oggetti evento aggiornata. La nuova struttura contiene ancora gli stessi campi oggetto evento utilizzati dai componenti aggiuntivi per videoconferenze di Gmail e Calendar, ma quei campi originali sono deprecati e verranno rimossi.
Passaggio 3: aggiorna il file manifest del componente aggiuntivo
Il modo in cui le informazioni di configurazione vengono archiviate nella struttura manifest dei componenti aggiuntivi di Google Workspace è cambiato notevolmente rispetto alla struttura utilizzata dai componenti aggiuntivi di Gmail e dai componenti aggiuntivi per conferenze di Calendar. Quando esegui l'upgrade del componente aggiuntivo, devi aggiornare i campi del file 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 file manifest, secondo necessità, in modo da riflettere le autorizzazioni richieste dal componente aggiuntivo aggiornato.
Per scoprire di più sui manifest dei componenti aggiuntivi di Google Workspace, consulta File manifest.
Componenti aggiuntivi di Gmail
| Campo manifest originale | Azione richiesta |
|---|---|
gmail.composeTrigger |
Sposta in addOns.gmail.composeTrigger. |
gmail.contextualTriggers[] |
Sposta l'elenco in addOns.gmail.contextualTriggers[]. |
gmail.logoUrl |
Sposta in addOns.common.logoUrl. |
gmail.name |
Sposta in addOns.common.name. |
gmail.openLinkUrlPrefixes[] |
Sposta l'elenco in addOns.common.openLinkUrlPrefixes[].
|
gmail.primaryColor |
Sposta in addOns.common.layoutProperties.primaryColor. |
gmail.secondaryColor |
Sposta in addOns.common.layoutProperties.secondaryColor.
|
gmail.universalActions[] |
Sposta l'elenco in 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 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 di cui è stato eseguito l'upgrade
Per testare il componente aggiuntivo di cui è stato eseguito l'upgrade prima della pubblicazione, consulta Test dei componenti aggiuntivi di Google Workspace.
Passaggio 5: richiedi le revisioni del componente aggiuntivo di cui è stato eseguito l'upgrade
Tutti i componenti aggiuntivi di Google Workspace, sia quelli di upgrade eseguito sia quelli creati da zero, devono essere approvati prima di poter essere elencati in Google Workspace Marketplace.
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 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 head.
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 i nuovi ambiti di Drive o Calendar nella versione del componente aggiuntivo di Google Workspace, dovrai inviare i nuovi ambiti per la verifica. La verifica spesso richiede alcuni giorni, quindi inizia la procedura il prima possibile. Assicurati che il componente aggiuntivo sia stato verificato prima di procedere con il 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 fornisci informazioni sul componente aggiuntivo.
Aggiorna la descrizione breve, la descrizione dettagliata e gli screenshot della tua scheda per riflettere 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 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 componente aggiuntivo di 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 file manifest del componente aggiuntivo.
Verifica che i dati inseriti nel modulo siano corretti. 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 relative agli upgrade dei componenti aggiuntivi:
Posso eseguire l'upgrade del mio componente aggiuntivo Editor?
La maggior parte dei componenti aggiuntivi 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à con cui sono disponibili 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 scheda.
Alcuni servizi del componente aggiuntivo Editor esistente potrebbero non essere disponibili nel servizio carta. Ad esempio, se il componente aggiuntivo Editor include un selettore file, non è disponibile un equivalente dal servizio carte per i componenti aggiuntivi di 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 per conferenze di Gmail o Calendar separati con lo stesso nome del brand del componente aggiuntivo di Google Workspace. Se hai domande o vuoi richiedere un'eccezione, contattaci.
Dopo l'upgrade, i miei utenti dovranno autorizzare nuovamente il componente aggiuntivo?
Se il componente aggiuntivo di Google Workspace utilizza lo stesso progetto Cloud Platform (Google Cloud) sottostante, con un ID client OAuth associato, non sarà necessario che gli utenti autorizzino nuovamente le autorizzazioni che avevano precedentemente autorizzato per il componente aggiuntivo originale. Tuttavia, se aggiungi nuovi ambiti durante il processo di upgrade, gli utenti dovranno autorizzarli la prima volta che utilizzano la versione Google Workspace del componente aggiuntivo.
Posso eseguire l'upgrade della mia estensione di Chrome a un componente aggiuntivo di Google Workspace e trasferire gli utenti?
No. Non puoi trasferire utenti, installazioni e recensioni delle schede di un'estensione di Chrome. Devi creare un nuovo componente aggiuntivo di Google Workspace e indirizzare gli utenti della tua estensione di Chrome a Google Workspace Marketplace.
Posso raggruppare più componenti aggiuntivi con il mio componente aggiuntivo di Google Workspace?
Consulta Elencare le integrazioni delle app.