- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- AccessProposal
- RoleAndView
- ลองใช้งาน
แสดงรายการ AccessProposals ในไฟล์ หมายเหตุ: มีเพียงผู้อนุมัติเท่านั้นที่จะแสดงรายการ AccessOffers ในไฟล์ได้ หากผู้ใช้ไม่ใช่ผู้อนุมัติ แสดงผล 403
คำขอ HTTP
GET https://www.googleapis.com/drive/v3/files/{fileId}/accessproposals
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
file |
ต้องระบุ รหัสของรายการที่มีคำขอ |
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
page |
ไม่บังคับ โทเค็นต่อเนื่องในรายการคำขอเข้าถึง |
page |
ไม่บังคับ จำนวนผลลัพธ์ต่อหน้า |
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
การตอบกลับคำขอรายการข้อเสนอการเข้าถึง
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"accessProposals": [
{
object ( |
ช่อง | |
---|---|
access |
รายการข้อเสนอการเข้าถึง ระบบจะสร้างช่องนี้ใน v3 และ v3beta เท่านั้น |
next |
โทเค็นการต่อหน้าสำหรับหน้าถัดไปของผลการค้นหา ซึ่งจะไม่มีข้อมูลนี้หากถึงส่วนท้ายของรายการผลลัพธ์แล้ว หากโทเค็นถูกปฏิเสธไม่ว่าด้วยเหตุผลใดก็ตาม ควรทิ้งและควรเริ่มใส่เลขหน้าใหม่ตั้งแต่หน้าแรกของผลการค้นหา |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้
https://www.googleapis.com/auth/docs
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.readonly
ขอบเขตบางอย่างถูกจํากัดและต้องมีการประเมินความปลอดภัยเพื่อให้แอปของคุณใช้งานได้ สำหรับข้อมูลเพิ่มเติม โปรดดูที่คู่มือการให้สิทธิ์
AccessProposal
แหล่งข้อมูลเกี่ยวกับข้อเสนอการเข้าถึงสำหรับข้อเสนอการเข้าถึงที่รอดำเนินการในไฟล์
การแสดง JSON |
---|
{
"fileId": string,
"proposalId": string,
"requesterEmailAddress": string,
"recipientEmailAddress": string,
"rolesAndViews": [
{
object ( |
ช่อง | |
---|---|
file |
รหัสไฟล์ที่ข้อเสนอการเข้าถึงเปิดอยู่ |
proposal |
รหัสของข้อเสนอการเข้าถึง |
requester |
อีเมลของผู้ใช้ที่ส่งคำขอ |
recipient |
อีเมลของผู้ใช้ที่จะได้รับสิทธิ์หากยอมรับ |
roles |
Wrapper สำหรับบทบาทและมุมมองของข้อเสนอการเข้าถึง |
request |
ข้อความที่ผู้ขอเพิ่มลงในข้อเสนอ |
create |
เวลาที่สร้าง การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่าง: |
RoleAndView
Wrapper สำหรับบทบาทและมุมมองของข้อเสนอการเข้าถึง
การแสดง JSON |
---|
{ "role": string, "view": string } |
ช่อง | |
---|---|
role |
บทบาทที่ผู้ขอเสนอ เราอาจเพิ่มค่าใหม่ในอนาคต แต่ปัจจุบันมีตัวเลือกต่อไปนี้ * |
view |
ระบุมุมมองสำหรับข้อเสนอการเข้าถึงนี้ ระบบจะป้อนข้อมูลสำหรับข้อเสนอที่เป็นของข้อมูลพร็อพเพอร์ตี้เท่านั้น |