ผสานรวมกับปุ่ม "ใหม่" 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 แอปจึงต้องจัดการ Escape แล้วแยกวิเคราะห์เป็น JSON

ผู้ใช้และ กิจกรรมใหม่

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