使用者按一下雲端硬碟 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。
您的應用程式必須按照下列步驟對這項要求採取行動:
- 確認
action
欄位的值為create
。 - 使用
userId
值為使用者建立新工作階段。如要進一步瞭解已登入的使用者,請參閱「使用者和新事件」。 - 請使用
files.create
方法建立檔案資源。如果要求中設定了folderId
,請將parents
欄位設為folderId
值。 - 如果要求中設定了
folderResourceKey
,請設定X-Goog-Drive-Resource-Keys
要求標頭。如要進一步瞭解資源金鑰,請參閱「使用資源金鑰存取連結共用的檔案」。
state
參數經過網址編碼,因此應用程式必須處理逸出字元並將其剖析為 JSON。
使用者和新活動
雲端硬碟應用程式應將所有「建立」事件視為可能的登入事件。部分使用者可能擁有多個帳戶,因此 state
參數中的使用者 ID 可能與目前的工作階段不符。如果 state
參數中的使用者 ID 與目前的工作階段不符,請結束應用程式的目前的工作階段,然後以要求的使用者登入。