Google Workspace 外掛程式可以提供自訂 介面。這樣您就能 提供額外相關資訊、自動執行工作,並連結第三方 遷移至 Google 雲端硬碟
存取外掛程式 UI
你可以前往以下位置開啟 Google Workspace 外掛程式: Google 雲端硬碟的圖示 雲端硬碟使用者介面右側的圖示欄。A 罩杯 Google Workspace 外掛程式 定義首頁介面和/或項目選取介面:
- 如果使用者在 Google 雲端硬碟中點選外掛程式圖示
執行外掛程式時
相應的
drive.homepageTrigger
函數 (如果有的話)。這個函式 建構並傳回首頁資訊卡 到 Google 雲端硬碟顯示如果答案為「否」drive.homepageTrigger
敬上 函式,將改為顯示一般首頁資訊卡。 - 如果使用者在 Google 雲端硬碟中選取一或多個項目,然後點選外掛程式
圖示或選取項目,外掛程式就會執行相應的
drive.onItemsSelectedTrigger
敬上 內容比對函式 (如果有的話)。這個函式會建立外掛程式的 Google 雲端硬碟 關聯「已選取項目」介面 並傳回給 Google 雲端硬碟來顯示
建立雲端硬碟外掛程式介面
只要遵循以下一般設定,即可建構擴充 Google 雲端硬碟的介面 步驟:
- 決定是否要為外掛程式建立雲端硬碟專屬 首頁。 此外,還決定要提供內容相關介面, 會選取雲端硬碟項目。
- 新增適當的
addOns.common
和 將addOns.drive
欄位加進 外掛程式指令碼專案 資訊清單,包括 需要使用任何雲端硬碟範圍。 - 如果您提供雲端硬碟專屬首頁,
實作
drive.homepageTrigger
敬上 函式來建構這個介面。您也可以選擇使用common.homepageTrigger
敬上 顯示多名 Google Workspace 主機的介面。 - 如果您提供的是雲端硬碟內容比對項目選取介面,您必須
實作
drive.onItemsSelectedTrigger
來建構這個介面 請參閱所選項目的雲端硬碟內容介面) 。 - 實作回應使用者的回呼所需的關聯回呼函式 使用者介面互動,例如按鈕點擊。
雲端硬碟首頁
Google 雲端硬碟可顯示 Google Workspace 外掛程式
首頁。
如要在 Google 雲端硬碟中顯示外掛程式的通用首頁,
是 addOns.drive
欄位
。
或者,新增
drive.homepageTrigger
敬上
新增至外掛程式資訊清單,以提供雲端硬碟專屬的首頁。
不論是哪一種情況,您都必須在
外掛程式的指令碼專案。系統會自動呼叫這個函式來建構
視需要使用雲端硬碟首頁。您必須實作這個函式,才能建構
傳回
Card
或
Card
構成首頁的 物件首頁觸發函式的
事件物件
做為參數,其中包含一些一般資訊,例如客戶的
平台。您可以使用事件物件資料,自訂
首頁。
所選項目的雲端硬碟內容介面
Google 雲端硬碟會透過內容相關觸發條件來判斷哪個介面
使用者選取一或多個 Google 雲端硬碟項目時顯示。當
就會執行
drive.onItemsSelectedTrigger.runFunction
敬上
] 欄位。
如要為雲端硬碟建立內容比對項目選取介面,您必須完成下列步驟: 包括:
確認外掛程式的資訊清單中包含
https://www.googleapis.com/auth/drive.addons.metadata.readonly
範圍請確認資訊清單包含
drive.onItemsSelectedTrigger
敬上 專區。實作
drive.onItemsSelectedTrigger
敬上 ] 欄位。 這個函式接受事件物件做為引數 且必須傳回Card
物件或Card
物件。與任何卡片一樣,您必須實作用於提供此服務的所有回呼函式 介面小工具的互動功能。舉例來說,如果您在廣告素材中加入按鈕 這個介面應該有 動作 並實作一個回呼函式,用於在點選按鈕時執行。
事件物件
系統會建立並傳送事件物件
「drive.homepageTrigger
」
或 drive.onItemsSelectedTrigger
而會觸發函式觸發函式可以使用
此事件物件中的資訊,以決定如何建構外掛程式卡
或以其他方式控管外掛程式行為
事件物件的完整結構說明 事件物件: 雲端硬碟是外掛程式關聯事件物件的操作代管應用程式 加入 雲端硬碟事件物件 來傳送雲端硬碟專屬用戶端資訊的欄位。
項目選取觸發條件的情境雲端硬碟事件物件包含資訊 觸發條件啟動時,使用者所選的項目。當使用者 在雲端硬碟中選取多個項目時,系統會將其中一個視為 主要利益;這個項目稱為有效遊標項目。
以下範例顯示
雲端硬碟事件物件
傳遞至
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"
},
...
]
},
...
}