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

 ได้รับสิทธิ์ตามรหัส

getIdForEmail

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

insert

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

list

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

patch

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

update

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