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

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

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

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

輸出內容包含下列值：

• create：執行的動作。當使用者按下 雲端硬碟 UI 的「New」按鈕時，這個值為 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。

使用者和新事件

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