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 เช่น "โจ สมิธ"
  • 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

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

list

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

update

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