Google Workspace 外掛程式可在使用者使用 Google 雲端硬碟時提供客製化介面。這樣一來，您就能為使用者提供其他相關資訊、自動執行工作，以及將第三方系統連結至 Google 雲端硬碟。
存取外掛程式 UI
你可以前往以下位置開啟 Google Workspace 外掛程式： Google 雲端硬碟的圖示 雲端硬碟使用者介面右側的圖示欄。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 雲端硬碟內容相關介面」。 - 實作回應使用者 UI 互動 (例如按鈕點擊) 所需的相關回呼函式。
雲端硬碟首頁
Google 雲端硬碟支援顯示 Google Workspace 外掛程式的首頁。如要在 Google 雲端硬碟中顯示外掛程式的通用首頁，只要確認外掛程式的資訊清單中含有 addOns.drive 欄位即可。
或者，新增
drive.homepageTrigger
新增至外掛程式資訊清單，以提供雲端硬碟專屬的首頁。
無論是哪種情況，您都必須在外掛程式指令碼專案中提供首頁觸發事件函式的名稱。系統會自動呼叫這個函式來建構
視需要使用雲端硬碟首頁。您必須實作這個函式，才能建構並傳回單一 Card 或 Card 物件的陣列，這些物件會組成首頁。這個首頁觸發事件函式會將事件物件傳遞為參數，其中包含一些一般資訊，例如用戶端的平台。您可以使用事件物件資料，自訂
首頁。
為所選項目提供 Drive 內容相關介面
Google 雲端硬碟會透過內容相關觸發條件來判斷哪個介面
使用者選取一或多個 Google 雲端硬碟項目時顯示。當
就會執行
drive.onItemsSelectedTrigger.runFunction
] 欄位。
如要為 Drive 建立內容相關項目選取介面，您必須執行下列操作：
確認外掛程式的資訊清單中包含
https://www.googleapis.com/auth/drive.addons.metadata.readonly範圍確認資訊清單包含
drive.onItemsSelectedTrigger段落。實作
drive.onItemsSelectedTrigger] 欄位。 這個函式會接受事件物件做為引數，且必須傳回單一Card物件或Card物件的陣列。如同任何資訊卡，您必須實作任何回呼函式，用於為介面提供小工具互動功能。舉例來說，如果您在介面中加入按鈕，該按鈕應附加 Action，並實作在按下按鈕時執行的回呼函式。
事件物件
在呼叫這些函式時，系統會建立 事件物件，並將其傳遞至 drive.homepageTrigger 或 drive.onItemsSelectedTrigger 觸發函式。觸發函式可以使用
此事件物件中的資訊，以決定如何建構外掛程式資訊卡
或以其他方式控管外掛程式行為
如要瞭解事件物件的完整結構，請參閱「事件物件」。雲端硬碟是外掛程式關聯事件物件的操作代管應用程式 加入 雲端硬碟事件物件 來傳送雲端硬碟專屬用戶端資訊的欄位。
項目選取觸發條件的情境雲端硬碟事件物件包含資訊 觸發條件啟動時，使用者所選的項目。當使用者在 Google 雲端硬碟中選取多個項目時，系統會將其中一個項目視為主要項目；這個項目稱為活動游標項目。
以下範例顯示
雲端硬碟事件物件
傳遞至
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"
},
...
]
},
...
}