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

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

然後，您的應用程式會在 state 參數中收到一組預設的範本變數。新網址的預設 state 資訊為：

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

這個輸出內容包含以下值：

  • create：正在執行的動作。當使用者按一下雲端硬碟 UI 的「新增」按鈕時，此值為 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 與目前的工作階段不符，請結束應用程式的目前的工作階段，然後以要求的使用者登入。