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

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

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

Google ไดรฟ์ 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 เพื่ออัปเดตสิทธิ์ในไฟล์หรือโฟลเดอร์ ดูข้อมูลเพิ่มเติมได้ที่อัปเดต สิทธิ์

หัวข้อที่เกี่ยวข้อง

• แชร์ไฟล์ โฟลเดอร์ และไดรฟ์