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 in questa pagina spiegano come aggiungere 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, le installazioni e gli utenti di Google Workspace Marketplace. L'upgrade consente inoltre di sfruttare le nuove funzionalità del componente aggiuntivo 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 aggiornata. L'upgrade di una copia del progetto di script originale comporta inoltre la possibilità di accedere sempre al codice originale e, se necessario, di eseguirne nuovamente il deployment in un secondo momento.
- Apri il componente aggiuntivo di Gmail o il progetto 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 > Modifica progetto.
- Fai clic su Numero di progetto Google Cloud.
- Inserisci lo stesso numero di progetto associato al progetto Apps Script pubblicato per il componente aggiuntivo esistente.
- Fai clic su Imposta progetto.
Passaggio 2: integra il componente aggiuntivo di Google Workspace
Devi progettare e implementare tutte le funzionalità del componente aggiuntivo di Google Workspace che vuoi aggiungere.
- Pianifica quali contenuti mostrare nelle schede della home page del componente aggiuntivo e se devono essere visualizzati in Gmail, Calendar, Drive o in una qualsiasi combinazione dei tre host. Se desideri che una home page sia presente in più host, decidi se può essere la stessa home page o se preferisci visualizzare schede della home page personalizzate per ciascun 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 le logiche 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 di Gmail o di un evento di Calendar.
Aggiorna qualsiasi accesso agli oggetti evento nel componente aggiuntivo (nelle funzioni di callback del widget o nelle funzioni di attivazione contestuale) per utilizzare la struttura degli oggetti evento aggiornata. La nuova struttura contiene ancora gli stessi campi degli oggetti evento utilizzati dai componenti aggiuntivi per le conferenze di Gmail e Calendar, ma i campi originali sono stati ritirati e alla fine 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 è notevolmente cambiata rispetto alla struttura utilizzata dai componenti aggiuntivi di Gmail e dai componenti aggiuntivi per le conferenze 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 proprietà secondarie pertinenti alla nuova
proprietà addOns.
Assicurati di aggiornare anche il campo oauthScopes del file manifest secondo necessità per riflettere le autorizzazioni richieste dal componente aggiuntivo aggiornato.
Per scoprire di più sui file manifest dei componenti aggiuntivi di Google Workspace, consulta 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 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 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 la revisione del componente aggiuntivo di cui è stato eseguito l'upgrade
Tutti i componenti aggiuntivi di Google Workspace, che si tratti di componenti aggiuntivi 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 componente aggiuntivo per la revisione:
Assicurati che il componente aggiuntivo soddisfi tutti i requisiti per la pubblicazione.
Crea un deployment con il 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 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 nuovi ambiti per 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 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 puoi fornire informazioni sul componente aggiuntivo.
Aggiorna la descrizione breve, la descrizione dettagliata e gli screenshot della 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 tuo 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 agli ambiti elencati nel file manifest del componente aggiuntivo.
Verifica che le informazioni inserite nel modulo siano corrette. Poi, fai clic su Salva modifiche.
In caso di domande o se riscontri un problema durante la procedura di upgrade dei componenti aggiuntivi di 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 eseguirne l'upgrade ai componenti aggiuntivi di Google Workspace con la stessa facilità dei componenti aggiuntivi di Gmail e Calendar.
Se vuoi eseguire la migrazione del componente aggiuntivo dell'editor a un componente aggiuntivo di Google Workspace, devi riscrivere la UI del componente aggiuntivo da HTML a interfaccia basata su schede e aggiornare la gestione JavaScript a Card Service.
Alcuni servizi del componente aggiuntivo Editor esistente potrebbero non essere disponibili in Card Service. Ad esempio, se il componente aggiuntivo dell'editor include un selettore di file, non ne sarà disponibile uno equivalente nei componenti aggiuntivi di Card Service per Google Workspace.
Posso creare un componente aggiuntivo di Google Workspace separato e mantenere quello esistente?
Puoi creare altri componenti aggiuntivi di Google Workspace con 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.
I miei utenti dovranno autorizzare di nuovo il componente aggiuntivo dopo l'upgrade?
Finché il componente aggiuntivo di Google Workspace utilizza lo stesso progetto di Cloud Platform (GCP) sottostante con un ID client OAuth associato, gli utenti non dovranno autorizzare nuovamente le autorizzazioni autorizzate in precedenza per il componente aggiuntivo originale. Tuttavia, se aggiungi nuovi ambiti durante il processo di upgrade, gli utenti devono autorizzarli la prima volta che utilizzano la versione di 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 gli utenti, le installazioni e le 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 l'articolo Elencare insieme le integrazioni delle app.