จัดการข้อเสนอการเข้าถึงที่รอดำเนินการ

ข้อเสนอการเข้าถึงคือข้อเสนอจากผู้ขอไปยังผู้อนุมัติเพื่อมอบสิทธิ์เข้าถึงรายการใน Google ไดรฟ์แก่ผู้รับ

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

Google Drive API มีทรัพยากร accessproposals เพื่อให้คุณดู และจัดการข้อเสนอการเข้าถึงที่รอดำเนินการได้ เมธอดของทรัพยากร accessproposals จะทำงานกับไฟล์ โฟลเดอร์ และไฟล์ภายในไดรฟ์ที่แชร์ แต่ ไม่ ทำงานกับไดรฟ์ที่แชร์

คำต่อไปนี้ใช้กับข้อเสนอการเข้าถึงโดยเฉพาะ

  • ผู้ขอ: ผู้ใช้ที่เริ่มข้อเสนอการเข้าถึงรายการใน ไดรฟ์
  • ผู้รับ: ผู้ใช้ที่จะได้รับสิทธิ์เพิ่มเติมในไฟล์หาก มีการให้สิทธิ์ตามข้อเสนอการเข้าถึง หลายครั้งที่ผู้รับเป็นคนเดียวกับผู้ขอ แต่ก็ไม่ใช่เสมอไป
  • ผู้อนุมัติ: ผู้ใช้ที่มีหน้าที่อนุมัติ (หรือปฏิเสธ) ข้อเสนอการเข้าถึง โดยปกติจะเป็นเจ้าของเอกสารหรือมีสิทธิ์แชร์เอกสาร

ใช้พารามิเตอร์ของฟิลด์ต่างๆ

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

รับข้อเสนอการเข้าถึงที่รอดำเนินการ

หากต้องการรับข้อเสนอการเข้าถึง ให้ใช้เมธอด get ในทรัพยากร accessproposals พร้อมพารามิเตอร์เส้นทาง fileId และ proposalId หากไม่ทราบรหัสข้อเสนอ คุณสามารถ แสดงรายการข้อเสนอการเข้าถึงที่รอดำเนินการได้โดยใช้เมธอด list

แสดงรายการข้อเสนอการเข้าถึงที่รอดำเนินการ

หากต้องการแสดงรายการข้อเสนอการเข้าถึงที่รอดำเนินการทั้งหมดในรายการในไดรฟ์ ให้เรียกเมธอด list ในทรัพยากร accessproposals และใส่พารามิเตอร์เส้นทาง fileId

เฉพาะผู้อนุมัติในไฟล์เท่านั้นที่แสดงรายการข้อเสนอที่รอดำเนินการในไฟล์ได้ ผู้อนุมัติคือผู้ใช้ที่มีความสามารถ can_approve_access_proposals ในไฟล์ หากผู้ขอไม่ใช่ผู้อนุมัติ ระบบจะแสดงผลรายการที่ว่างเปล่า ดูข้อมูลเพิ่มเติม เกี่ยวกับ capabilities ได้ที่ ทำความเข้าใจความสามารถของไฟล์

เนื้อหาการตอบกลับ ประกอบด้วยaccessproposalsออบเจ็กต์ ซึ่งแสดงรายการข้อเสนอ การเข้าถึงที่ยังไม่ได้รับการจัดการในไฟล์

ออบเจ็กต์ accessproposals มีข้อมูลเกี่ยวกับข้อเสนอแต่ละรายการ เช่น ผู้ขอ ผู้รับ และข้อความที่ผู้ขอเพิ่ม นอกจากนี้ยังมี ออบเจ็กต์ RoleAndView ที่จัดกลุ่ม role ที่เสนอของผู้ขอด้วย view เนื่องจาก role เป็นฟิลด์ที่เกิดขึ้นซ้ำ จึงอาจมีหลายรายการสำหรับข้อเสนอแต่ละรายการ ตัวอย่างเช่น ข้อเสนออาจมีออบเจ็กต์ RoleAndView ที่มี role=reader และ view=published รวมถึงออบเจ็กต์ RoleAndView เพิ่มเติมที่มีเฉพาะค่า role=writer ดูข้อมูลเพิ่มเติมได้ที่ มุมมอง

ส่งพารามิเตอร์การค้นหาต่อไปนี้เพื่อปรับแต่งการแบ่งหน้าหรือกรองข้อเสนอการเข้าถึง

  • pageToken: โทเค็นหน้าเว็บที่ได้รับจากการเรียกรายการก่อนหน้า ระบุโทเค็นนี้เพื่อดึงข้อมูลหน้าถัดไป

  • pageSize: จำนวนข้อเสนอการเข้าถึงสูงสุดที่จะแสดงผลต่อหน้า

จัดการข้อเสนอการเข้าถึงที่รอดำเนินการ

หากต้องการจัดการข้อเสนอการเข้าถึงที่รอดำเนินการทั้งหมดในรายการในไดรฟ์ ให้เรียกเมธอด resolve ใน ทรัพยากร accessproposals และใส่ พารามิเตอร์เส้นทาง fileId และ proposalId

เมธอด resolve มีพารามิเตอร์การค้นหา action ที่ระบุการดำเนินการที่จะทำกับข้อเสนอ ออบเจ็กต์ Action จะติดตามการเปลี่ยนแปลงสถานะของข้อเสนอเพื่อให้ทราบว่าข้อเสนอได้รับการยอมรับหรือปฏิเสธ

เมธอด resolve ยังมีพารามิเตอร์การค้นหาที่ไม่บังคับ role และ view ด้วย `role` ที่รองรับมีเพียง writer, commenter และ reader หากไม่ได้ระบุ role ระบบจะใช้ reader เป็นค่าเริ่มต้น ดูข้อมูลเพิ่มเติมได้ที่ บทบาท และสิทธิ์ พารามิเตอร์การค้นหาที่ไม่บังคับเพิ่มเติม sendNotification ช่วยให้คุณส่งการแจ้งเตือนทางอีเมลไปยังผู้ขอเมื่อมีการยอมรับหรือปฏิเสธข้อเสนอ

เช่นเดียวกับเมธอด list ผู้ใช้ที่จัดการข้อเสนอต้องมีความสามารถ can_approve_access_proposals ในไฟล์ ดูข้อมูลเพิ่มเติม เกี่ยวกับ capabilities ได้ที่ ทำความเข้าใจความสามารถของไฟล์

ระบบจะจัดการข้อเสนอโดยใช้รูปแบบเดียวกันกับที่ระบุไว้ใน สถานการณ์สำหรับการ แชร์ทรัพยากรในไดรฟ์ หากมีข้อเสนอหลายรายการสำหรับผู้ใช้รายเดียวกัน แต่มีบทบาทต่างกัน ระบบจะใช้กฎต่อไปนี้

  • หากมีการยอมรับข้อเสนอหนึ่งรายการและปฏิเสธอีกรายการหนึ่ง ระบบจะใช้บทบาทที่ยอมรับกับรายการในไดรฟ์
  • หากมีการยอมรับข้อเสนอทั้ง 2 รายการพร้อมกัน ระบบจะใช้ข้อเสนอที่มีสิทธิ์สูงกว่า (เช่น role=writer เทียบกับ role=reader) และนำข้อเสนอการเข้าถึงอื่นๆ ออกจากรายการ

หลังจากส่งข้อเสนอไปยังเมธอด resolve การดำเนินการแชร์จะเสร็จสมบูรณ์ ระบบจะไม่แสดงผลข้อเสนอการเข้าถึงที่จัดการแล้วผ่านเมธอด list อีกต่อไป เมื่อยอมรับข้อเสนอแล้ว ผู้ใช้ต้องใช้ทรัพยากร permissions เพื่ออัปเดตสิทธิ์ในไฟล์หรือ โฟลเดอร์ ดูข้อมูลเพิ่มเติมได้ที่ อัปเดต สิทธิ์