Limitazioni

Esistono alcune limitazioni per le funzionalità dei componenti aggiuntivi. Migliora l'esperienza complessiva dei tuoi utenti evitando questi problemi.

Limitazioni generali

A tutti i componenti aggiuntivi si applicano le seguenti limitazioni. Non fare quanto segue:

Modificare le funzionalità in Google Workspace

Il framework dei componenti aggiuntivi è progettato per migliorare le applicazioni di Google Workspace, non per aggiungere limiti. Di conseguenza, non puoi modificare le funzionalità esistenti o bloccare il modello di condivisione dei documenti di Google Workspace.

Addebitare agli utenti un costo per l'installazione

Non forniamo un modo per addebitare agli utenti l'installazione di componenti aggiuntivi e questi non possono includere annunci. Tuttavia, puoi implementare il tuo sistema di pagamento o chiamare un database di fatturazione esistente. Il tuo componente aggiuntivo può connettersi a servizi non Google che addebitano agli utenti.

Rilevare molti eventi

Ad eccezione di determinati attivatori, i componenti aggiuntivi non possono sapere cosa fa un utente al di fuori del componente aggiuntivo stesso. Ad esempio, non puoi rilevare quando l'utente fa clic sulla barra degli strumenti dell'applicazione host. È possibile eseguire il polling per rilevare le modifiche ai contenuti di un file dal codice lato client di una barra laterale, anche se ci sarà sempre un leggero ritardo.

Componenti aggiuntivi di Google Workspace

Le seguenti limitazioni si applicano solo ai componenti aggiuntivi di Google Workspace e all'utilizzo del servizio Schede. Non fare quanto segue:

Estendere tutte le app di Google Workspace

I componenti aggiuntivi di Google Workspace possono estendere solo Gmail, Calendar, Drive, Documenti, Fogli e Presentazioni. In futuro, i componenti aggiuntivi di Google Workspace potranno estendere altre applicazioni Google Workspace.

Attivazione contestuale in Drive

I componenti aggiuntivi di Google Workspace possono fornire l'attivazione contestuale solo per Gmail durante la lettura o la composizione dei messaggi e in Calendar quando gli eventi sono aperti. L'attivazione contestuale per i file di Drive non è ancora supportata. Consulta le practice di sviluppo intermedie.

Contesto del documento negli editor

I componenti aggiuntivi di Google Workspace non supportano ancora l'uso del contesto del documento negli editor. In altre parole, non puoi utilizzare metodi come SpreadsheetApp.getActiveSpreadsheet() per acquisire il documento corrente. Consulta le practice di sviluppo intermedie.

Utilizzare HTML/CSS o scripting lato client

I componenti aggiuntivi di Google Workspace devono utilizzare interfacce basate su schede. Non è possibile utilizzare le interfacce HTML/CSS supportate dai componenti aggiuntivi di Editor. I componenti aggiuntivi di Google Workspace utilizzano un approccio basato su widget per la creazione di interfacce utente. In questo modo, il componente aggiuntivo funziona bene su piattaforme desktop e mobile senza che tu debba creare un'interfaccia per ciascuna.

Supporto completo per i dispositivi mobili

Per il momento, i componenti aggiuntivi di Google Workspace funzionano su client web desktop. L'attivazione contestuale (ovvero la lettura dei messaggi di Gmail) è supportata anche dall'app mobile Gmail. Le home page non contestuali non sono ancora disponibili dalle app mobile Gmail, Calendar o Drive. I componenti aggiuntivi di Google Workspace non sono disponibili dai browser web mobile.

Utilizzare gli attivatori di Apps Script

Non puoi creare o utilizzare gli attivatori semplici di Apps Script in un componente aggiuntivo di Google Workspace.

Utilizzare le immagini SVG

Al momento non puoi utilizzare le immagini SVG con le schede e i widget del servizio di schede.

Hai più di 100 widget

Per motivi di rendimento, non puoi aggiungere più di 100 widget o 100 sezioni di schede a una scheda.