設定雲端硬碟 UI 整合

如要在使用者建立或開啟檔案時,在 Google 雲端硬碟中顯示您的應用程式,您可以 必須先設定雲端硬碟使用者介面 (UI) 整合功能。 您也必須完成設定,您的應用程式才會出現在 Google Workspace Marketplace

啟用 Drive API

使用 Google API 前,請先前往 Google Cloud 啟用 API 專案。您可以在單一 Google Cloud 中啟用一或多個 API 專案。

如要開始與 Google 雲端硬碟 UI 整合,您必須啟用 Drive API。以便存取 API 和 UI 整合項目 接著介紹網際網路通訊層 包括兩項主要的安全防護功能

  • 在 Google Cloud 控制台中,啟用 Google Drive API。

    啟用 API

設定雲端硬碟 UI 整合功能

  1. 在 Google API 控制台中,前往「選單」圖示 > API 與服務 > 已啟用的 API 和服務

    前往「已啟用的 API」頁面服務

  2. API 底部在「服務」資訊主頁中,按一下「Google Drive API」。 Google Drive API 設定頁面隨即顯示。
  3. 選取「雲端硬碟 UI 整合」分頁標籤。
  4. (選用) 在「應用程式名稱」欄位中輸入名稱。應用程式 使用者可在雲端硬碟的「管理應用程式」分頁中看到名稱 可以管理叢集設定,像是節點 資源調度、安全性和其他預先設定項目
  5. (選用) 在「簡短說明」中輸入一行簡短的說明 ] 欄位。簡短說明會顯示在以下帳戶的「管理應用程式」分頁中: 。
  6. (選用) 在「詳細說明」欄位中輸入完整說明。
  7. 上傳一或多個應用程式圖示,以便在使用者的清單中顯示。 已連結的雲端硬碟應用程式,以及「選擇開啟工具」內容選單 圖示必須是 PNG 格式,並使用透明背景。圖示可使用一點 最多 24 小時就會顯示在雲端硬碟中。

  8. 如何使用雲端硬碟使用者介面的「選擇開啟工具」選單 ,請在 。這個網址將用於「選擇開啟工具」內容選單

    • 此網址必須包含完整的網域名稱;localhost 並未 這些研究有助於我們找出 能引導後續作業的標準
    • 應用程式的目標使用者應該要能存取這個網址。 如果您有多個應用程式版本,例如一個供公開的應用程式版本 另一個是受限版本,可供特定使用者發布 使用不重複的網址接著請建立不同的應用程式 每個版本的設定
    • 您必須 驗證這個網址的擁有權 ,才能在 Google Workspace Marketplace 上架應用程式。
    • 根據預設,系統會將 state 查詢參數附加至這個網址,以便將 準確擷取雲端硬碟資料到應用程式。如需深入瞭解 state 參數的內容,請參閱「state 參數
  9. (選用) 在 預設 MIME 類型和「預設副檔名」欄位。預設 MIME 類型和副檔名分別代表應用程式 開啟。舉例來說,應用程式可能會開啟內建的格式 編輯圖片。只包含標準媒體 類型 並確認其中沒有錯字和錯別字如果應用程式僅開啟 捷徑或第三方捷徑檔案,可以將 MIME 類型留空。

  10. (選用) 在 [次要] 欄位輸入次要 MIME 類型和副檔名。 MIME 類型次要副檔名欄位。次要 MIME 類型 副檔名代表應用程式可開啟的檔案,但非特定檔案 導入您的應用程式舉例來說,您的應用程式可能是開啟的圖片編輯應用程式 PNG 和 JPG 圖片。只包含標準媒體 類型 並確認其中沒有錯字和錯別字如果應用程式僅開啟 捷徑或第三方捷徑檔案,可以將 MIME 類型留空。

  11. 如何使用雲端硬碟 UI 的「新功能」 按鈕,讓使用者透過 已勾選「建立檔案」方塊。新網址 (選填) 系統隨即顯示「文件名稱」欄位。

    • 此網址必須包含完整的網域名稱;localhost 並未 這些研究有助於我們找出 能引導後續作業的標準
    • 您必須驗證此項目的擁有權 網址 ,才能在 Google Workspace Marketplace 上架應用程式。
    • 根據預設,系統會將 state 查詢參數附加至這個網址,以便將 準確擷取雲端硬碟資料到應用程式。如需深入瞭解 state 參數的內容,請參閱「state 參數
  12. 在「新增網址」欄位中輸入網址。這個網址將由「新品」按鈕 將使用者重新導向至您的應用程式。

  13. (選用) 如要讓應用程式開啟 Google Workspace 支援的檔案, 勾選「匯入」方塊。

  14. (選用) 如果應用程式必須管理共用雲端硬碟中的檔案,請查看 「支援共用雲端硬碟」方塊。請深入瞭解如何取得支援 請參閱這篇文章,瞭解如何導入共用雲端硬碟 支援團隊

  15. 按一下 [提交]。

要求 drive.install 範圍

如要讓應用程式顯示為「選擇開啟工具」的選項或「新功能」選單 要求 https://www.googleapis.com/auth/drive.install 範圍整合 即可開始使用。要求這個範圍時,使用者會收到 類似下方的對話方塊:

Google 雲端硬碟使用者介面的安裝對話方塊。
圖 1. 使用雲端硬碟 UI 範圍時,安裝對話方塊。

如要進一步瞭解您可以為雲端硬碟應用程式要求的範圍,請 以及如何提出要求,請參閱 API 專屬授權與驗證 資訊

state 參數

根據預設,系統會同時將 state 參數附加至開啟網址和新網址 ,將資料從雲端硬碟使用者介面傳送到應用程式。這個參數 包含 JSON 編碼字串,其中包含範本變數與 向您的應用程式提出要求包含的變數取決於所使用的網址類型 (開啟) 網址或新網址):

範本變數 說明 網址應用程式
{ids} 逗號分隔的檔案 ID 清單。 開啟網址
{exportIds} 匯出要匯出的檔案 ID 清單 (僅限使用) 這項功能)。 開啟網址
{resourceKeys} 對應至個別資源的檔案 ID 的 JSON 字典 鍵。 開啟網址
{folderId} 父項資料夾的 ID。 新增網址
{folderResourceKey} 父項資料夾的資源金鑰。 新增網址
{userId} 用來識別使用者的設定檔 ID。 開啟網址和新網址
{action} 正在執行的動作。值為 使用開啟網址或 create 時:open 也別忘了加入過新網址 開啟網址和新網址

state 參數經過網址編碼,因此您的應用程式必須處理逸出 並剖析為 JSON 格式應用程式可以偵測 create 值, state 參數,用於驗證建立檔案的要求。

新網址的 JSON 狀態資訊範例

新網址的 state 資訊如下:

{
  "action":"create",
  "folderId":"FOLDER_ID",
  "folderResourceKey":"FOLDER_RESOURCE_KEY",
  "userId":"USER_ID"
}

開啟網址的 JSON 狀態資訊範例

開啟網址的 state 資訊如下:

{
  "ids": ["ID"],
  "resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
  "action":"open",
  "userId":"USER_ID"
}

ID 和資源金鑰可用來擷取檔案中繼資料及下載檔案 內容。應用程式取得檔案 ID 和存取權杖後,即可 權限、擷取檔案中繼資料,然後依說明下載檔案內容 在 files.get 方法中定義。

已安裝的應用程式必須能夠建立、管理及開啟透過下列來源啟動的動作 雲端硬碟 UI詳情請參閱與 雲端硬碟 UI 的「新功能」按鈕與雲端硬碟 UI 的「選擇開啟工具」整合情境 選單