I componenti aggiuntivi di Google Workspace possono fornire quando l'utente usa Google Drive. Questo ti permette di fornire all'utente ottenere ulteriori informazioni pertinenti, automatizzare le attività e mettere in contatto i tuoi sistemi su Google Drive.
Accesso all'interfaccia utente del componente aggiuntivo
Puoi aprire un componente aggiuntivo di Google Workspace in Google Drive, se la sua icona appare nel colonna dell'icona sul lato destro dell'interfaccia utente di Drive. R Il componente aggiuntivo di Google Workspace può definisci un'interfaccia della home page, un'interfaccia di selezione degli elementi o entrambe:
- Se un utente fa clic sull'icona del componente aggiuntivo su Google Drive,
il componente aggiuntivo esegue
il token
drive.homepageTrigger
corrispondente (se presente). Questa funzione crea e restituisce una scheda home page su Google Drive per la visualizzazione. In caso contrariodrive.homepageTrigger
viene definita una funzione, viene visualizzata una scheda generica della home page. - Se l'utente seleziona uno o più elementi su Google Drive e poi fa clic sul componente aggiuntivo
o seleziona gli elementi mentre il componente aggiuntivo è aperto, il componente esegue
drive.onItemsSelectedTrigger
funzione contestuale (se presente). Questa funzione crea il Google Drive del componente aggiuntivo "elementi selezionati" contestuali interfaccia e lo restituisce a Google Drive per la visualizzazione.
Creazione dell'interfaccia del componente aggiuntivo Drive
Puoi creare interfacce che estendono Google Drive seguendo queste informazioni generali passaggi:
- Decidi se il tuo componente aggiuntivo deve avere un'interfaccia specifica homepage. Decidi anche se vuoi fornire un'interfaccia contestuale per quando e seleziona gli elementi di Drive.
- Aggiungi il token appropriato
addOns.common
eaddOns.drive
campi per il progetto di script del componente aggiuntivo manifest, inclusi eventuali ambiti Drive richiesti. - Se fornisci una home page specifica per Drive,
di implementare
drive.homepageTrigger
: per creare questa interfaccia. Puoi anche scegliere di utilizzarecommon.homepageTrigger
per più host Google Workspace. - Se fornisci un'interfaccia di selezione degli elementi contestuali di Drive, devi
implementare un
drive.onItemsSelectedTrigger
di trigger contestuale per creare questa interfaccia. Vedi Interfaccia contestuale di Drive per gli elementi selezionati) per maggiori dettagli. - Implementare le funzioni di callback associate necessarie per rispondere alla richiesta Interazioni con l'interfaccia utente, come i clic sui pulsanti.
Home page di Drive
Google Drive supporta la visualizzazione del componente aggiuntivo di Google Workspace
home page.
Per visualizzare la home page comune del componente aggiuntivo su Google Drive, assicurati semplicemente che
è un campo addOns.drive
nel file manifest del componente aggiuntivo.
In alternativa, aggiungi un elemento
drive.homepageTrigger
al file manifest del componente aggiuntivo per fornire una home page specifica per Drive.
In entrambi i casi, devi specificare il nome di una funzione di trigger della home page nel
progetto di script del componente aggiuntivo. Questa funzione viene chiamata automaticamente per creare
Home page di Drive quando necessario. Devi implementare questa funzione per creare e
restituiscono un singolo
Card
o un array di
Card
:
gli oggetti che compongono la home page. Alla funzione di trigger della home page viene inviato
oggetto evento
parametro contenente alcune informazioni generali come il parametro
completamente gestita. Puoi utilizzare i dati dell'oggetto evento per personalizzare la costruzione dell'oggetto
homepage.
Interfaccia contestuale di Drive per gli elementi selezionati
Google Drive si basa su un trigger contestuale per determinare quale interfaccia
(se presenti) da visualizzare quando l'utente seleziona uno o più elementi di Google Drive. Quando
l'attivatore si attiva, esegue la funzione di attivazione contestuale specificata
drive.onItemsSelectedTrigger.runFunction
nel campo manifest del componente aggiuntivo.
Per creare un'interfaccia di selezione contestuale degli elementi per Drive, devi eseguire la seguenti:
Assicurati che il manifest del componente aggiuntivo includa il parametro
https://www.googleapis.com/auth/drive.addons.metadata.readonly
ambitoAssicurati che il manifest includa un
drive.onItemsSelectedTrigger
.Implementare la funzione denominata nel
drive.onItemsSelectedTrigger
. Questa funzione accetta un oggetto evento come argomento e deve restituire un soloCard
o un array diCard
oggetti.Come per qualsiasi carta, devi implementare le funzioni di callback utilizzate per fornire l'interattività del widget per l'interfaccia. Ad esempio, se includi un pulsante nell'interfaccia, dovrebbe avere un allegato Azione e una funzione di callback implementata che viene eseguita quando un utente fa clic sul pulsante.
Oggetti evento
Viene creato e passato un oggetto evento.
alle drive.homepageTrigger
oppure drive.onItemsSelectedTrigger
quando vengono richiamate queste funzioni. La funzione trigger può utilizzare
le informazioni in questo oggetto evento per determinare come costruire le schede dei componenti aggiuntivi
o controllare il comportamento del componente aggiuntivo.
La struttura completa degli oggetti evento è descritta in Oggetti evento. Se Drive è l'app ospitante del componente aggiuntivo, gli oggetti degli eventi contestuali includi il Oggetto evento Drive che contiene informazioni sul client specifiche di Drive.
Gli oggetti di eventi contestuali di Drive per gli attivatori di selezione degli elementi includono informazioni sugli elementi selezionati dall'utente quando l'attivatore si attiva. Quando un utente seleziona più di un elemento in Drive, uno degli elementi è considerato uno di interesse principale; questo elemento è indicato come elemento del cursore attivo.
L'esempio seguente mostra un
Oggetto evento Drive
che viene passato a un
drive.onItemsSelectedTrigger
:
:
{
"commonEventObject": { ... },
"drive": {
"activeCursorItem":{
"addonHasFileScopePermission": true,
"id":"0B_sX1fXRRU6Ac3RhcnRlcl9maWxl",
"iconUrl": "https://drive-thirdparty.googleusercontent.com...",
"mimeType":"application/pdf",
"title":"How to get started with Drive"
},
"selectedItems": [
{
"addonHasFileScopePermission": true,
"id":"0B_sX1fXRRU6Ac3RhcnRlcl9maWxl",
"iconUrl":"https://drive-thirdparty.googleusercontent.com...",
"mimeType":"application/pdf",
"title":"How to get started with Drive"
},
...
]
},
...
}