Method: files.accessproposals.list

แสดงรายการ AccessProposals ในไฟล์ หมายเหตุ: มีเพียงผู้อนุมัติเท่านั้นที่จะแสดงรายการ AccessOffers ในไฟล์ได้ หากผู้ใช้ไม่ใช่ผู้อนุมัติ แสดงผล 403

คำขอ HTTP

GET https://www.googleapis.com/drive/v3/files/{fileId}/accessproposals

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
fileId

string

ต้องระบุ รหัสของรายการที่มีคำขอ

พารามิเตอร์การค้นหา

พารามิเตอร์
pageToken

string

ไม่บังคับ โทเค็นต่อเนื่องในรายการคำขอเข้าถึง

pageSize

integer

ไม่บังคับ จำนวนผลลัพธ์ต่อหน้า

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

การตอบกลับคำขอรายการข้อเสนอการเข้าถึง

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON
{
  "accessProposals": [
    {
      object (AccessProposal)
    }
  ],
  "nextPageToken": string
}
ช่อง
accessProposals[]

object (AccessProposal)

รายการข้อเสนอการเข้าถึง ระบบจะสร้างช่องนี้ใน v3 และ v3beta เท่านั้น

nextPageToken

string

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต 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 (RoleAndView)
    }
  ],
  "requestMessage": string,
  "createTime": string
}
ช่อง
fileId

string

รหัสไฟล์ที่ข้อเสนอการเข้าถึงเปิดอยู่

proposalId

string

รหัสของข้อเสนอการเข้าถึง

requesterEmailAddress

string

อีเมลของผู้ใช้ที่ส่งคำขอ

recipientEmailAddress

string

อีเมลของผู้ใช้ที่จะได้รับสิทธิ์หากยอมรับ

rolesAndViews[]

object (RoleAndView)

Wrapper สำหรับบทบาทและมุมมองของข้อเสนอการเข้าถึง

requestMessage

string

ข้อความที่ผู้ขอเพิ่มลงในข้อเสนอ

createTime

string (Timestamp format)

เวลาที่สร้าง

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

RoleAndView

Wrapper สำหรับบทบาทและมุมมองของข้อเสนอการเข้าถึง

การแสดง JSON
{
  "role": string,
  "view": string
}
ช่อง
role

string

บทบาทที่ผู้ขอเสนอ เราอาจเพิ่มค่าใหม่ในอนาคต แต่ปัจจุบันมีตัวเลือกต่อไปนี้ * writer * commenter * reader

view

string

ระบุมุมมองสำหรับข้อเสนอการเข้าถึงนี้ ระบบจะป้อนข้อมูลสำหรับข้อเสนอที่เป็นของข้อมูลพร็อพเพอร์ตี้เท่านั้น published เป็นค่าเดียวที่รองรับ