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

ข้อเสนอการเข้าถึง คือข้อเสนอจากผู้ขอไปยังผู้อนุมัติเพื่อมอบสิทธิ์เข้าถึงรายการใน 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 ด้วย บทบาทที่รองรับมีเพียง writer, commenter และ reader หากไม่ได้ระบุบทบาท ระบบจะใช้ reader เป็นค่าเริ่มต้น ดูข้อมูลเพิ่มเติมได้ที่ บทบาท และสิทธิ์ พารามิเตอร์การค้นหาที่ไม่บังคับเพิ่มเติมของ sendNotification ช่วยให้คุณส่งการแจ้งเตือนทางอีเมลไปยังผู้ขอเมื่อมีการยอมรับหรือปฏิเสธข้อเสนอ

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

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

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

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