建構 Google 雲端硬碟介面

Google Workspace 外掛程式可以提供自訂 介面。這樣您就能 提供額外相關資訊、自動執行工作，並連結第三方 遷移至 Google 雲端硬碟

存取外掛程式 UI

你可以前往以下位置開啟 Google Workspace 外掛程式： Google 雲端硬碟的圖示 雲端硬碟使用者介面右側的圖示欄。A 罩杯 Google Workspace 外掛程式 定義首頁介面和/或項目選取介面：

  • 如果使用者在 Google 雲端硬碟中點選外掛程式圖示 執行外掛程式時 相應的 drive.homepageTrigger 函數 (如果有的話)。這個函式 建構並傳回首頁資訊卡 到 Google 雲端硬碟顯示如果答案為「否」 drive.homepageTrigger敬上 函式，將改為顯示一般首頁資訊卡。
  • 如果使用者在 Google 雲端硬碟中選取一或多個項目，然後點選外掛程式 圖示或選取項目，外掛程式就會執行相應的 drive.onItemsSelectedTrigger敬上 內容比對函式 (如果有的話)。這個函式會建立外掛程式的 Google 雲端硬碟 關聯「已選取項目」介面 並傳回給 Google 雲端硬碟來顯示

建立雲端硬碟外掛程式介面

只要遵循以下一般設定，即可建構擴充 Google 雲端硬碟的介面 步驟：

  1. 決定是否要為外掛程式建立雲端硬碟專屬 首頁。 此外，還決定要提供內容相關介面， 會選取雲端硬碟項目。
  2. 新增適當的 addOns.common 和 將 addOns.drive 欄位加進 外掛程式指令碼專案 資訊清單，包括 需要使用任何雲端硬碟範圍。
  3. 如果您提供雲端硬碟專屬首頁， 實作 drive.homepageTrigger敬上 函式來建構這個介面。您也可以選擇使用 common.homepageTrigger敬上 顯示多名 Google Workspace 主機的介面。
  4. 如果您提供的是雲端硬碟內容比對項目選取介面，您必須 實作 drive.onItemsSelectedTrigger 來建構這個介面 請參閱所選項目的雲端硬碟內容介面) 。
  5. 實作回應使用者的回呼所需的關聯回呼函式 使用者介面互動，例如按鈕點擊。

雲端硬碟首頁

Google 雲端硬碟可顯示 Google Workspace 外掛程式 首頁。 如要在 Google 雲端硬碟中顯示外掛程式的通用首頁， 是 addOns.drive 欄位 。

或者，新增 drive.homepageTrigger敬上 新增至外掛程式資訊清單，以提供雲端硬碟專屬的首頁。

不論是哪一種情況，您都必須在 外掛程式的指令碼專案。系統會自動呼叫這個函式來建構 視需要使用雲端硬碟首頁。您必須實作這個函式，才能建構 傳回 Card 或 Card 構成首頁的 物件首頁觸發函式的 事件物件 做為參數，其中包含一些一般資訊，例如客戶的 平台。您可以使用事件物件資料，自訂 首頁。

所選項目的雲端硬碟內容介面

Google 雲端硬碟會透過內容相關觸發條件來判斷哪個介面 使用者選取一或多個 Google 雲端硬碟項目時顯示。當 就會執行 drive.onItemsSelectedTrigger.runFunction敬上 ] 欄位。

如要為雲端硬碟建立內容比對項目選取介面，您必須完成下列步驟： 包括：

  1. 確認外掛程式的資訊清單中包含 https://www.googleapis.com/auth/drive.addons.metadata.readonly 範圍

  2. 請確認資訊清單包含 drive.onItemsSelectedTrigger敬上 專區。

  3. 實作 drive.onItemsSelectedTrigger敬上 ] 欄位。 這個函式接受事件物件做為引數 且必須傳回 Card 物件或 Card 物件。

  4. 與任何卡片一樣，您必須實作用於提供此服務的所有回呼函式 介面小工具的互動功能。舉例來說，如果您在廣告素材中加入按鈕 這個介面應該有 動作 並實作一個回呼函式，用於在點選按鈕時執行。

事件物件

系統會建立並傳送事件物件 「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"
          },
          ...
        ]
      },
      ...
    }