เมื่อผู้ใช้คลิกปุ่ม "ใหม่" ของ 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
ไม่ตรงกับเซสชันปัจจุบัน ให้สิ้นสุดเซสชันปัจจุบันสำหรับแอป
ของคุณ แล้วลงชื่อเข้าใช้ในฐานะผู้ใช้ที่ขอ