與雲端硬碟使用者介面整合(&A)

使用者點選雲端硬碟 UI 的「新增」按鈕，並在雲端硬碟 UI 中選取應用程式時，雲端硬碟會將使用者重新導向至該應用程式的「新增」網址，該網址是在「設定雲端硬碟 UI 整合」中定義。

應用程式接著會在 state 參數中收到一組預設範本變數。新網址的預設state 資訊如下：

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

這項輸出內容包含下列值：

  • create：正在執行的動作。使用者點選雲端硬碟使用者介面的「新增」按鈕時，值為 create。
  • FOLDER_ID：父項資料夾的 ID。
  • FOLDER_RESOURCE_KEY：父項資料夾的資源鍵。
  • USER_ID：可專屬識別使用者的設定檔 ID。

應用程式必須按照下列步驟處理這項要求：

  1. 確認 action 欄位的值為 create。
  2. 使用 userId 值為使用者建立新工作階段。如要進一步瞭解已登入的使用者，請參閱「使用者和新事件」。
  3. 使用 files.create 方法建立檔案資源。如果要求中已設定 folderId，請將 parents 欄位設為 folderId 值。
  4. 如果要求中已設定 folderResourceKey，請設定 X-Goog-Drive-Resource-Keys 要求標頭。如要進一步瞭解資源金鑰，請參閱「使用資源金鑰存取透過連結共用的檔案」。

state 參數經過網址編碼，因此應用程式必須處理逸出字元，並將其剖析為 JSON。

使用者和新事件

雲端硬碟應用程式應將所有「建立」事件視為潛在登入事件。部分使用者可能有多個帳戶，因此 state 參數中的使用者 ID 可能與目前的工作階段不符。如果 state 參數中的使用者 ID 與目前工作階段不符，請結束應用程式的目前工作階段，並以要求的使用者身分登入。