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

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