REST Resource: permissions

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

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

เมธอดทรัพยากรบางอย่าง (เช่น permissions.update) ต้องใช้ permissionId ให้ใช้เมธอด permissions.list เพื่อเรียกข้อมูลรหัสสำหรับไฟล์ โฟลเดอร์ หรือไดรฟ์ที่แชร์

การแสดง JSON 
{
  "id": string,
  "name": string,
  "type": string,
  "role": string,
  "additionalRoles": [
    string
  ],
  "authKey": string,
  "value": string,
  "kind": string,
  "withLink": boolean,
  "photoLink": string,
  "selfLink": string,
  "emailAddress": string,
  "domain": string,
  "etag": string,
  "permissionDetails": [
    {
      "permissionType": string,
      "role": string,
      "additionalRoles": [
        string
      ],
      "inheritedFrom": string,
      "inherited": boolean
    }
  ],
  "expirationDate": string,
  "teamDrivePermissionDetails": [
    {
      "teamDrivePermissionType": string,
      "role": string,
      "additionalRoles": [
        string
      ],
      "inheritedFrom": string,
      "inherited": boolean
    }
  ],
  "deleted": boolean,
  "view": string,
  "pendingOwner": boolean
}
ช่อง
id

string

รหัสของผู้ใช้ที่มีสิทธิ์นี้อ้างถึง และเหมือนกับ permissionId ในทรัพยากร "เกี่ยวกับ" และ "ไฟล์" เมื่อส่งคำขอ drive.permissions.insert คุณต้องระบุข้อมูลในช่อง id หรือ value เพียงช่องใดช่องหนึ่ง ยกเว้นกรณีที่ประเภทสิทธิ์คือ anyone ซึ่งในกรณีนี้ระบบจะไม่สนใจทั้ง id และ value
name

string

เอาต์พุตเท่านั้น ชื่อของสิทธิ์นี้
type

string

ประเภทบัญชี ค่าที่ใช้ได้คือ

  • user
  • group
  • domain
  • anyone
role

string

บทบาทหลักสำหรับผู้ใช้รายนี้ แม้ว่าระบบอาจรองรับค่าใหม่ๆ ในอนาคต แต่ในปัจจุบันระบบอนุญาตให้ใช้ค่าต่อไปนี้

  • owner
  • organizer
  • fileOrganizer
  • writer
  • reader
additionalRoles[]

string

บทบาทเพิ่มเติมสำหรับผู้ใช้รายนี้ ปัจจุบันระบบอนุญาตให้ใช้ได้เพียง commenter เท่านั้น แต่ระบบอาจรองรับการรองรับอื่นๆ เพิ่มเติมในอนาคต
authKey
(deprecated)

string

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

string

อีเมลหรือชื่อโดเมนสำหรับเอนทิตี โดยจะใช้ระหว่างการแทรกและจะไม่สร้างในคำตอบ เมื่อส่งคำขอ drive.permissions.insert คุณต้องระบุข้อมูลในช่อง id หรือ value เพียงช่องใดช่องหนึ่ง ยกเว้นกรณีที่ประเภทสิทธิ์คือ anyone ซึ่งในกรณีนี้ระบบจะไม่สนใจทั้ง id และ value
kind

string

เอาต์พุตเท่านั้น เป็น drive#permission เสมอ
emailAddress

string

เอาต์พุตเท่านั้น อีเมลของผู้ใช้หรือกลุ่มที่สิทธิ์นี้อ้างถึง นี่คือช่องเอาต์พุตเท่านั้นที่จะแสดงเมื่อประเภทสิทธิ์คือ user หรือ group
domain

string

เอาต์พุตเท่านั้น ชื่อโดเมนของเอนทิตีที่สิทธิ์นี้ใช้อ้างอิง นี่คือช่องเอาต์พุตเท่านั้นที่จะแสดงเมื่อประเภทสิทธิ์คือ user, group หรือ domain
etag

string

เอาต์พุตเท่านั้น ETag ของสิทธิ์
permissionDetails[]

object

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

string

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

  • file
  • member
permissionDetails[].role

string

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

  • organizer
  • fileOrganizer
  • writer
  • reader
permissionDetails[].additionalRoles[]

string

เอาต์พุตเท่านั้น บทบาทเพิ่มเติมสำหรับผู้ใช้รายนี้ ขณะนี้ระบบใช้ได้เพียง commenter เท่านั้น แต่อาจรองรับอุปกรณ์อื่นๆ เพิ่มเติมในอนาคต
permissionDetails[].inheritedFrom

string

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

boolean

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

string

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

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

object

เอาต์พุตเท่านั้น เลิกใช้งานแล้ว: ใช้ permissionDetails แทน
teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

เอาต์พุตเท่านั้น เลิกใช้งานแล้ว: ใช้ permissionDetails/permissionType แทน
teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

เอาต์พุตเท่านั้น เลิกใช้งานแล้ว: ใช้ permissionDetails/role แทน
teamDrivePermissionDetails[]
(deprecated).additionalRoles[]
(deprecated)

string

เอาต์พุตเท่านั้น เลิกใช้งานแล้ว: ใช้ permissionDetails/additionalRoles แทน
teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

เอาต์พุตเท่านั้น เลิกใช้งานแล้ว: ใช้ permissionDetails/inheritedFrom แทน
teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

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

boolean

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

string

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

boolean

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

วิธีการ

delete

 ลบสิทธิ์ออกจากไฟล์หรือไดรฟ์ที่แชร์

get

 ได้รับสิทธิ์จาก ID

getIdForEmail

 แสดงรหัสสิทธิ์สำหรับอีเมล

insert

 แทรกสิทธิ์สำหรับไฟล์หรือไดรฟ์ที่แชร์

list

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

patch

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

update

 อัปเดตสิทธิ์