ผสานรวมกับปุ่ม "ใหม่" UI ของไดรฟ์

เมื่อผู้ใช้คลิกปุ่ม "ใหม่" ของ 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: รหัสโปรไฟล์ที่ระบุผู้ใช้โดยไม่ซ้ำกัน

แอปของคุณต้องดำเนินการตามคำขอนี้โดยทำตามขั้นตอนต่อไปนี้

1. ตรวจสอบว่าช่อง action มีค่าเป็น create
2. ใช้ค่า userId เพื่อสร้างเซสชันใหม่สําหรับผู้ใช้ ดูข้อมูลเพิ่มเติมเกี่ยวกับผู้ใช้ที่ลงชื่อเข้าใช้ได้ที่ผู้ใช้และเหตุการณ์ใหม่
3. ใช้เมธอด files.create เพื่อสร้างทรัพยากรไฟล์ หากมีการตั้งค่า folderId ในคำขอ ให้ตั้งค่าช่อง parents เป็นค่า folderId
4. หากตั้งค่า folderResourceKey ในคำขอ ให้ตั้งค่าส่วนหัวของคำขอ X-Goog-Drive-Resource-Keys ดูข้อมูลเพิ่มเติมเกี่ยวกับคีย์ทรัพยากรได้ที่เข้าถึงไฟล์ที่แชร์ลิงก์โดยใช้คีย์ทรัพยากร

พารามิเตอร์ state ได้รับการเข้ารหัส URL ดังนั้นแอปของคุณต้องจัดการอักขระหลีกและแยกวิเคราะห์เป็น JSON

ผู้ใช้และเหตุการณ์ใหม่

แอปไดรฟ์ควรถือว่าเหตุการณ์ "สร้าง" ทั้งหมดเป็นการลงชื่อเข้าใช้ที่เป็นไปได้ ผู้ใช้บางรายอาจมีหลายบัญชี ดังนั้นรหัสผู้ใช้ในพารามิเตอร์ state อาจไม่ตรงกับเซสชันปัจจุบัน หากรหัสผู้ใช้ในพารามิเตอร์ state ไม่ตรงกับเซสชันปัจจุบัน ให้ปิดเซสชันปัจจุบันของแอปและลงชื่อเข้าใช้ในฐานะผู้ใช้ที่ขอ