เมื่อผู้ใช้คลิกปุ่ม "ใหม่" ของ UI ของไดรฟ์และเลือกแอปใน UI ของไดรฟ์ ไดรฟ์จะเปลี่ยนเส้นทางผู้ใช้ไปยัง URL ใหม่ของแอปนั้น ตามที่ระบุไว้ในกำหนดค่าการผสานรวม UI ของไดรฟ์
จากนั้นแอปจะได้รับชุดตัวแปรเทมเพลตเริ่มต้นภายในพารามิเตอร์ state
ข้อมูล state
เริ่มต้นสำหรับ URL ใหม่คือ
{
"action":"create",
"folderId":"FOLDER_ID",
"folderResourceKey":"FOLDER_RESOURCE_KEY",
"userId":"USER_ID"
}
เอาต์พุตนี้มีค่าต่อไปนี้
create
: การดำเนินการที่กำลังดำเนินการ ค่าจะเป็นcreate
เมื่อผู้ใช้คลิกปุ่ม "ใหม่" ของ UI ของไดรฟ์- FOLDER_ID: รหัสของโฟลเดอร์หลัก
- FOLDER_RESOURCE_KEY: คีย์ทรัพยากรของโฟลเดอร์หลัก
- USER_ID: รหัสโปรไฟล์ที่ระบุตัวผู้ใช้ได้แบบไม่ซ้ำกัน
แอปของคุณต้องดําเนินการตามคําขอนี้โดยทําตามขั้นตอนต่อไปนี้
- ตรวจสอบว่าช่อง
action
มีค่าเป็นcreate
- ใช้ค่า
userId
เพื่อสร้างเซสชันใหม่ให้กับผู้ใช้ ดูข้อมูลเพิ่มเติมเกี่ยวกับผู้ใช้ที่ลงชื่อเข้าใช้ได้ที่ผู้ใช้และกิจกรรมใหม่ - ใช้เมธอด
files.create
เพื่อสร้างทรัพยากรไฟล์ หากตั้งค่าfolderId
ในคำขอ ให้ตั้งค่าช่องparents
เป็นค่าfolderId
- หากมีการตั้งค่า
folderResourceKey
ในคำขอ ให้ตั้งค่าส่วนหัวของคำขอX-Goog-Drive-Resource-Keys
ดูข้อมูลเพิ่มเติมเกี่ยวกับคีย์ทรัพยากรได้ที่เข้าถึงไฟล์ที่แชร์ลิงก์ด้วยคีย์ทรัพยากร
พารามิเตอร์ state
มีการเข้ารหัส URL แอปของคุณจึงต้องจัดการอักขระหลีกและแยกวิเคราะห์เป็น JSON
ผู้ใช้และกิจกรรมใหม่
แอปไดรฟ์ควรถือว่าเหตุการณ์ "สร้าง" ทั้งหมดเป็นการลงชื่อเข้าใช้ที่อาจเกิดขึ้น ผู้ใช้บางรายอาจมีหลายบัญชี ดังนั้นรหัสผู้ใช้ในพารามิเตอร์ state
อาจไม่ตรงกับเซสชันปัจจุบัน หากรหัสผู้ใช้ในพารามิเตอร์ state
ไม่ตรงกับเซสชันปัจจุบัน ให้สิ้นสุดเซสชันปัจจุบันของแอปแล้วลงชื่อเข้าใช้ในฐานะผู้ใช้ที่ขอ