REST Resource: permissions

ทรัพยากร: สิทธิ์

สิทธิ์สําหรับไฟล์ สิทธิ์ดังกล่าวจะให้สิทธิ์ผู้ใช้ กลุ่ม โดเมน หรือสิทธิ์ทั่วโลกในการเข้าถึงไฟล์หรือโฟลเดอร์ในลําดับชั้นอื่น

วิธีการจัดการทรัพยากรบางอย่าง (เช่น 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

string

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

displayName

string

เอาต์พุตเท่านั้น ชื่อ "ที่สวยงาม" ของค่าของสิทธิ์ รายการต่อไปนี้คือตัวอย่างรายการสิทธิ์แต่ละประเภท

  • user - ชื่อเต็มของผู้ใช้ตามที่กําหนดไว้ในบัญชี Google เช่น "Joe Smith"
  • group - ชื่อกลุ่มของ Google เช่น "ผู้ดูแลระบบของบริษัท"
  • domain - ชื่อโดเมนที่เป็นสตริง เช่น "thecompany.com"
  • anyone - ไม่มี displayName
type

string

ประเภทของผู้รับ ค่าที่ใช้ได้มีดังนี้

  • user
  • group
  • domain
  • anyone

เมื่อสร้างสิทธิ์ หาก type เป็น user หรือ group คุณต้องระบุ emailAddress สําหรับผู้ใช้หรือกลุ่ม เมื่อ type เป็น domain คุณต้องระบุ domain ไม่จําเป็นต้องมีข้อมูลเพิ่มเติมสําหรับประเภท anyone

kind

string

เอาต์พุตเท่านั้น ระบุประเภทของทรัพยากรนี้ ค่า: สตริงคงที่ "drive#permission"

permissionDetails[]

object

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

permissionDetails[].permissionType

string

เอาต์พุตเท่านั้น ประเภทสิทธิ์สําหรับผู้ใช้รายนี้ แม้ว่าอาจมีการเพิ่มค่าใหม่ๆ อีกในอนาคต แต่ปัจจุบันมีดังต่อไปนี้

  • file
  • member
permissionDetails[].inheritedFrom

string

เอาต์พุตเท่านั้น รหัสของรายการที่รับช่วงสิทธิ์นี้ ช่องนี้เป็นช่องเอาต์พุตเท่านั้น

permissionDetails[].role

string

เอาต์พุตเท่านั้น บทบาทหลักของผู้ใช้รายนี้ แม้ว่าอาจมีการเพิ่มค่าใหม่ในอนาคต แต่ก็มีความเป็นไปได้ต่อไปนี้

  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader
permissionDetails[].inherited

boolean

เอาต์พุตเท่านั้น สิทธิ์นี้รับช่วงต่อหรือไม่ ช่องนี้จะเติมข้อมูลเสมอ ช่องนี้เป็นช่องเอาต์พุตเท่านั้น

emailAddress

string

อีเมลของผู้ใช้หรือกลุ่มที่สิทธิ์นี้อ้างอิงถึง

role

string

บทบาทที่ได้รับจากสิทธิ์นี้ แม้ว่าอาจมีการรองรับค่าใหม่ในอนาคต แต่เราอนุญาตค่าต่อไปนี้

  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader
allowFileDiscovery

boolean

สิทธิ์นี้ทําให้สามารถค้นพบไฟล์ผ่านการค้นหาได้หรือไม่ การดําเนินการนี้ใช้ได้กับสิทธิ์ประเภท domain หรือ anyone เท่านั้น

domain

string

โดเมนที่สิทธิ์นี้อ้างอิง

expirationTime

string

ระยะเวลาที่สิทธิ์นี้จะหมดอายุ (วันที่และเวลา RFC 3339) เวลาหมดอายุมีข้อจํากัดดังต่อไปนี้

  • การตั้งค่าเหล่านี้ทําได้เฉพาะในสิทธิ์ของผู้ใช้และกลุ่ม
  • เวลาต้องเป็นเวลาในอนาคต
  • เวลาต้องไม่เกิน 1 ปีนับจากนี้
teamDrivePermissionDetails[]
(deprecated)

object

เอาต์พุตเท่านั้น เลิกใช้งานแล้ว: เอาต์พุตเท่านั้น ใช้ permissionDetails แทน

teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

เลิกใช้งานแล้ว: เอาต์พุตเท่านั้น ใช้ permissionDetails/permissionType แทน

teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

เลิกใช้งานแล้ว: เอาต์พุตเท่านั้น ใช้ permissionDetails/inheritedFrom แทน

teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

เลิกใช้งานแล้ว: เอาต์พุตเท่านั้น ใช้ permissionDetails/role แทน

teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

เลิกใช้งานแล้ว: เอาต์พุตเท่านั้น ใช้ permissionDetails/inherited แทน

deleted

boolean

เอาต์พุตเท่านั้น บัญชีที่เชื่อมโยงกับสิทธิ์นี้ถูกลบแล้วหรือไม่ ช่องนี้เกี่ยวข้องกับสิทธิ์ของผู้ใช้และกลุ่มเท่านั้น

view

string

ระบุมุมมองสําหรับสิทธิ์นี้ ป้อนข้อมูลสําหรับสิทธิ์ที่อยู่ในข้อมูลพร็อพเพอร์ตี้เท่านั้น "เผยแพร่แล้ว" เป็นค่าเดียวที่สนับสนุน

pendingOwner

boolean

บัญชีที่เชื่อมโยงกับสิทธิ์นี้เป็นเจ้าของที่รอการตอบรับหรือไม่ ป้อนข้อมูลสําหรับสิทธิ์ประเภท user สําหรับไฟล์ที่ไม่ได้อยู่ในไดรฟ์ที่แชร์เท่านั้น

วิธีการ

create

สร้างสิทธิ์สําหรับไฟล์หรือไดรฟ์ที่แชร์

delete

ลบสิทธิ์

get

รับสิทธิ์ตาม ID

list

แสดงรายการสิทธิ์ของไฟล์หรือไดรฟ์ที่แชร์

update

อัปเดตสิทธิ์ด้วยความหมายของแพตช์