與雲端硬碟 UI 的 [新增] 按鈕整合

當使用者按一下「Drive UI」的 [New] 按鈕，並在雲端硬碟 UI 中選取應用程式時，雲端硬碟會將使用者重新導向該應用程式的新網址，詳情請參閱設定雲端硬碟 UI 整合。

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

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

此輸出結果包含下列值：

• create：進行的動作。當使用者按一下「Drive 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。

使用者和新活動

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