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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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