ทรัพยากร: สิทธิ์
สิทธิ์สําหรับไฟล์ สิทธิ์ดังกล่าวจะให้สิทธิ์ผู้ใช้ กลุ่ม โดเมน หรือสิทธิ์ทั่วโลกในการเข้าถึงไฟล์หรือโฟลเดอร์ในลําดับชั้นอื่น
วิธีการจัดการทรัพยากรบางอย่าง (เช่น permissions.update
) ต้องใช้ permissionId
ใช้วิธีการ permissions.list
เพื่อเรียกข้อมูลรหัสสําหรับไฟล์ โฟลเดอร์ หรือไดรฟ์ที่แชร์
การแสดง JSON |
---|
{ "id": string, "displayName": string, "type": string, "kind": string, "permissionDetails": [ { "permissionType": string, "inheritedFrom": string, "role": string, "inherited": boolean } ], "photoLink": string, "emailAddress": string, "role": string, "allowFileDiscovery": boolean, "domain": string, "expirationTime": string, "teamDrivePermissionDetails": [ { "teamDrivePermissionType": string, "inheritedFrom": string, "role": string, "inherited": boolean } ], "deleted": boolean, "view": string, "pendingOwner": boolean } |
ช่อง | |
---|---|
id |
เอาต์พุตเท่านั้น รหัสสิทธิ์นี้ นี่คือตัวระบุที่ไม่ซ้ําสําหรับผู้รับและเผยแพร่ในทรัพยากรของผู้ใช้เป็น |
displayName |
เอาต์พุตเท่านั้น ชื่อ "ที่สวยงาม" ของค่าของสิทธิ์ รายการต่อไปนี้คือตัวอย่างรายการสิทธิ์แต่ละประเภท
|
type |
ประเภทของผู้รับ ค่าที่ใช้ได้มีดังนี้
เมื่อสร้างสิทธิ์ หาก |
kind |
เอาต์พุตเท่านั้น ระบุประเภทของทรัพยากรนี้ ค่า: สตริงคงที่ |
permissionDetails[] |
เอาต์พุตเท่านั้น รายละเอียดว่าสิทธิ์ในรายการในไดรฟ์ที่แชร์นี้รับค่าเดิมหรือมาจากรายการนี้โดยตรง ช่องนี้เป็นช่องเอาต์พุตเท่านั้นซึ่งจะมีรายการในไดรฟ์ที่แชร์เท่านั้น |
permissionDetails[].permissionType |
เอาต์พุตเท่านั้น ประเภทสิทธิ์สําหรับผู้ใช้รายนี้ แม้ว่าอาจมีการเพิ่มค่าใหม่ๆ อีกในอนาคต แต่ปัจจุบันมีดังต่อไปนี้
|
permissionDetails[].inheritedFrom |
เอาต์พุตเท่านั้น รหัสของรายการที่รับช่วงสิทธิ์นี้ ช่องนี้เป็นช่องเอาต์พุตเท่านั้น |
permissionDetails[].role |
เอาต์พุตเท่านั้น บทบาทหลักของผู้ใช้รายนี้ แม้ว่าอาจมีการเพิ่มค่าใหม่ในอนาคต แต่ก็มีความเป็นไปได้ต่อไปนี้
|
permissionDetails[].inherited |
เอาต์พุตเท่านั้น สิทธิ์นี้รับช่วงต่อหรือไม่ ช่องนี้จะเติมข้อมูลเสมอ ช่องนี้เป็นช่องเอาต์พุตเท่านั้น |
photoLink |
เอาต์พุตเท่านั้น ลิงก์ไปยังรูปโปรไฟล์ของผู้ใช้ (หากมี) |
emailAddress |
อีเมลของผู้ใช้หรือกลุ่มที่สิทธิ์นี้อ้างอิงถึง |
role |
บทบาทที่ได้รับจากสิทธิ์นี้ แม้ว่าอาจมีการรองรับค่าใหม่ในอนาคต แต่เราอนุญาตค่าต่อไปนี้
|
allowFileDiscovery |
สิทธิ์นี้ทําให้สามารถค้นพบไฟล์ผ่านการค้นหาได้หรือไม่ การดําเนินการนี้ใช้ได้กับสิทธิ์ประเภท |
domain |
โดเมนที่สิทธิ์นี้อ้างอิง |
expirationTime |
ระยะเวลาที่สิทธิ์นี้จะหมดอายุ (วันที่และเวลา RFC 3339) เวลาหมดอายุมีข้อจํากัดดังต่อไปนี้
|
teamDrivePermissionDetails[] |
เอาต์พุตเท่านั้น เลิกใช้งานแล้ว: เอาต์พุตเท่านั้น ใช้ |
teamDrivePermissionDetails[] |
เลิกใช้งานแล้ว: เอาต์พุตเท่านั้น ใช้ |
teamDrivePermissionDetails[] |
เลิกใช้งานแล้ว: เอาต์พุตเท่านั้น ใช้ |
teamDrivePermissionDetails[] |
เลิกใช้งานแล้ว: เอาต์พุตเท่านั้น ใช้ |
teamDrivePermissionDetails[] |
เลิกใช้งานแล้ว: เอาต์พุตเท่านั้น ใช้ |
deleted |
เอาต์พุตเท่านั้น บัญชีที่เชื่อมโยงกับสิทธิ์นี้ถูกลบแล้วหรือไม่ ช่องนี้เกี่ยวข้องกับสิทธิ์ของผู้ใช้และกลุ่มเท่านั้น |
view |
ระบุมุมมองสําหรับสิทธิ์นี้ ป้อนข้อมูลสําหรับสิทธิ์ที่อยู่ในข้อมูลพร็อพเพอร์ตี้เท่านั้น "เผยแพร่แล้ว" เป็นค่าเดียวที่สนับสนุน |
pendingOwner |
บัญชีที่เชื่อมโยงกับสิทธิ์นี้เป็นเจ้าของที่รอการตอบรับหรือไม่ ป้อนข้อมูลสําหรับสิทธิ์ประเภท |
วิธีการ |
|
---|---|
|
สร้างสิทธิ์สําหรับไฟล์หรือไดรฟ์ที่แชร์ |
|
ลบสิทธิ์ |
|
รับสิทธิ์ตาม ID |
|
แสดงรายการสิทธิ์ของไฟล์หรือไดรฟ์ที่แชร์ |
|
อัปเดตสิทธิ์ด้วยความหมายของแพตช์ |