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,
  "inheritedPermissionsDisabled": 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

และ

metadata

เป็นค่าที่รองรับเพียงค่าเดียว

  • published

    : บทบาทของสิทธิ์คือ published_reader

  • metadata

    : รายการจะแสดงในมุมมองข้อมูลเมตาเท่านั้น เนื่องจากรายการมีสิทธิ์เข้าถึงแบบจํากัดและขอบเขตมีสิทธิ์เข้าถึงระดับบนสุดในระดับอ่านเป็นอย่างน้อย หมายเหตุ:

    metadata

    ขณะนี้รองรับเฉพาะในโฟลเดอร์

pendingOwner

boolean

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

boolean

เมื่อเป็น "จริง" จะมีเพียงผู้จัด เจ้าของ และผู้ใช้ที่มีสิทธิ์ซึ่งเพิ่มในรายการโดยตรงเท่านั้นที่จะเข้าถึงรายการนั้นได้

เมธอด

delete

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

get

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

getIdForEmail

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

insert

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

list

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

patch

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

update

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