Se hai già creato e pubblicato un componente aggiuntivo per estendere Gmail o Calendar, puoi eseguirne l'upgrade in un componente aggiuntivo di Google Workspace. Le istruzioni riportate in questa pagina descrivono in dettaglio di aggiungere le funzionalità di Google Workspace ai componenti aggiuntivi esistenti di Gmail o Calendar e quindi pubblica il componente aggiuntivo con upgrade eseguito, in modo che possa essere rilevato e installato.
Puoi trasferire la nuova funzionalità nel file per conservare la scheda, le installazioni e gli utenti di Google Workspace Marketplace. L'upgrade ti consente inoltre 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 tuo componente aggiuntivo
Il componente aggiuntivo di cui hai eseguito l'upgrade utilizza lo stesso progetto Google Cloud di quello pubblicato del componente aggiuntivo, ma è importante creare e usare una copia Progetto di script in modo che gli utenti esistenti non siano interessati durante il test la versione aggiornata. È stato eseguito anche l'upgrade di una copia del progetto di script originale puoi sempre accedere al codice originale e rieseguire il deployment in un secondo momento necessaria.
- Apri lo script di Apps Script del tuo componente aggiuntivo di Gmail o del componente aggiuntivo per conferenze di Calendar progetto.
- 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 progetto associati al progetto Apps Script esistente e pubblicato per il componente aggiuntivo.
- 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 il componente aggiuntivo.
- Pianifica i contenuti da mostrare nei componenti aggiuntivi schede sulla home page e se devono essere visualizzati in Gmail, Calendar, Drive o in una qualsiasi combinazione dei tre . Se vuoi che una home page sia in più host, decidi se può essere la stessa home page o se vuoi ricevere schede personalizzate per ciascun host.
- Nel progetto Apps Script del componente aggiuntivo copiato, crea la tua home page
carte con
homepageTriggerfunzioni. Assicurati di includere le logiche o le funzioni 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 Gmail oppure Evento nel calendario.
Aggiornare qualsiasi accesso agli oggetti evento Nel componente aggiuntivo (nelle funzioni di callback del widget o nell'attivatore contestuale ) per utilizzare il modello struttura dell'oggetto evento. La nuova struttura contiene ancora gli stessi campi oggetto evento utilizzati dalla per i componenti aggiuntivi per videoconferenze di Gmail e Calendar, ma i campi originali sono è deprecata e verrà rimossa.
Passaggio 3: aggiorna il file manifest del componente aggiuntivo
Il modo in cui le informazioni di configurazione vengono archiviate
struttura del file manifest
La struttura dei componenti aggiuntivi di Google Workspace è cambiata notevolmente rispetto alla struttura dei componenti aggiuntivi di Gmail
e i componenti aggiuntivi per conferenze di Calendar. Quando esegui l'upgrade di un componente aggiuntivo, devi aggiornare i campi del file manifest del progetto Apps Script del componente aggiuntivo
alle tabelle seguenti. Devi aggiornare tutte le proprietà secondarie pertinenti alla nuova
Proprietà addOns.
Assicurati di aggiornare anche il file manifest
oauthScopes campo come
necessarie per riflettere le 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 |
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
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 l'articolo Testare i 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 categoria superiore che 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 tutte le requisiti di pubblicazione dei componenti aggiuntivi.
Crea un deployment con controllo delle versioni del tuo componente aggiuntivo Google Workspace (nel nuovo progetto Apps Script) utilizzando la versione di il codice che vuoi pubblicare. Non tentare di pubblicare utilizzando un'intestazione e deployment continuo.
Se hai aggiunto nuovi ambiti durante l'upgrade del componente aggiuntivo, devi richiedi la verifica OAuth. Ad esempio, se il componente aggiuntivo di Gmail utilizza i nuovi ambiti Drive o Calendar In caso di versione del componente aggiuntivo Google Workspace, devi sottoporre questi nuovi ambiti alla 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 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 fornisci informazioni sul tuo componente aggiuntivo.
Aggiorna la descrizione breve, la descrizione dettagliata e gli screenshot del tuo dell'elenco per riflettere la nuova funzionalità del componente aggiuntivo di Google Workspace.
In Estensioni, fai clic su Esegui l'upgrade a Pulsante Componente aggiuntivo di Google Workspace. Nella casella di testo visualizzata, inserisci il nuovo ID deployment che hai creato per sul tuo componente aggiuntivo di Google Workspace nel passaggio precedente. Se l'ID deployment è valido, viene visualizzato l'elenco degli host supportati.
Se hai aggiunto nuovi ambiti al tuo componente aggiuntivo di Google Workspace, assicurati di aggiungerli al Sezione Ambiti OAuth 2.0 nella pagina Configurazione. Gli ambiti elencati in questa sezione devono corrispondere esattamente agli ambiti elencati nel del file manifest.
Verifica che i dati inseriti nel modulo siano corretti. Quindi, fai clic su Salva modifiche.
Se hai domande o riscontri un problema durante l'upgrade di questo componente aggiuntivo di Google Workspace procedura, 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 possono essere eseguire l'upgrade ai componenti aggiuntivi di Google Workspace con la stessa facilità con cui i componenti aggiuntivi per Gmail Calendario.
Se vuoi eseguire la migrazione del tuo componente aggiuntivo Editor a un componente aggiuntivo di Google Workspace, devi riscrivere l'interfaccia utente del componente aggiuntivo da HTML a basata su schede interfaccia utente e aggiorna il tuo codice JavaScript gestione delle carte al Servizio carte.
Alcuni servizi nel componente aggiuntivo Editor esistente potrebbero non essere disponibili in Servizio carta. Ad esempio, se il componente aggiuntivo Editor include un selettore file, non è un equivalente disponibile dal servizio carta 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 l'utilizzo di componenti aggiuntivi per le conferenze di Gmail o Calendar separati nome del brand del tuo 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?
Purché il componente aggiuntivo di Google Workspace utilizzi la stessa base Progetto Google Cloud, con un ID client OAuth associato, non sarà necessario autorizzare nuovamente gli utenti autorizzazioni che ha precedentemente autorizzato per il componente aggiuntivo originale. Tuttavia, se aggiungi nuovi ambiti durante il processo di upgrade, gli utenti devono autorizzarli nuovi ambiti la prima volta che utilizzano Google Workspace del tuo 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 schede di un'estensione di Chrome le recensioni. Devi creare un nuovo componente aggiuntivo di Google Workspace e indirizzare gli utenti 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.