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