REST Resource: permissions

แหล่งข้อมูล: สิทธิ์

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

โดยค่าเริ่มต้น คำขอสิทธิ์จะแสดงเฉพาะฟิลด์บางส่วนเท่านั้น ระบบจะแสดงสิทธิ์ kind, ID, type และ role เสมอ หากต้องการดึงข้อมูลฟิลด์ที่เฉพาะเจาะจง โปรดดูแสดงฟิลด์ที่เฉพาะเจาะจง

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

การแสดง JSON
{
  "permissionDetails": [
    {
      "permissionType": string,
      "inheritedFrom": string,
      "role": string,
      "inherited": boolean
    }
  ],
  "teamDrivePermissionDetails": [
    {
      "teamDrivePermissionType": string,
      "inheritedFrom": string,
      "role": string,
      "inherited": boolean
    }
  ],
  "id": string,
  "displayName": string,
  "type": string,
  "kind": string,
  "photoLink": string,
  "emailAddress": string,
  "role": string,
  "allowFileDiscovery": boolean,
  "domain": string,
  "expirationTime": string,
  "deleted": boolean,
  "view": string,
  "pendingOwner": boolean,
  "inheritedPermissionsDisabled": boolean
}
ช่อง
permissionDetails[]

object

เอาต์พุตเท่านั้น รายละเอียดว่าสิทธิ์ในรายการนี้เป็นสิทธิ์ที่รับค่ามาหรือเป็นสิทธิ์ในรายการนี้โดยตรง

permissionDetails[].permissionType

string

เอาต์พุตเท่านั้น ประเภทสิทธิ์สำหรับผู้ใช้รายนี้ ค่าที่รองรับมีดังนี้

  • file
  • member
permissionDetails[].inheritedFrom

string

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

permissionDetails[].role

string

เอาต์พุตเท่านั้น บทบาทหลักของผู้ใช้รายนี้ ค่าที่รองรับมีดังนี้

  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader

ดูข้อมูลเพิ่มเติมได้ที่บทบาทและสิทธิ์

permissionDetails[].inherited

boolean

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

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 แทน

id

string

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

displayName

string

เอาต์พุตเท่านั้น ชื่อที่ "น่ารัก" ของค่าของสิทธิ์ โดยตัวอย่างสิทธิ์แต่ละประเภทมีดังนี้

  • user - ชื่อเต็มของผู้ใช้ตามที่กำหนดไว้สำหรับบัญชี Google เช่น "Dana A."
  • group - ชื่อกลุ่ม Google เช่น "ผู้ดูแลระบบของบริษัท"
  • domain - ชื่อโดเมนสตริง เช่น "cymbalgroup.com"
  • anyone - ไม่มี displayName
type

string

ประเภทของผู้รับเงินช่วยเหลือ ค่าที่รองรับมีดังนี้

  • user
  • group
  • domain
  • anyone

เมื่อสร้างสิทธิ์ หาก type เป็น user หรือ group คุณต้องระบุ emailAddress สำหรับผู้ใช้หรือกลุ่ม หาก type เป็น domain คุณต้องระบุ domain หาก type เป็น anyone คุณไม่จำเป็นต้องระบุข้อมูลเพิ่มเติม

kind

string

เอาต์พุตเท่านั้น ระบุประเภทของทรัพยากร ค่า: สตริงคงที่ "drive#permission"

emailAddress

string

อีเมลของผู้ใช้หรือกลุ่มที่สิทธิ์นี้อ้างอิง

role

string

บทบาทที่ได้รับจากสิทธิ์นี้ ค่าที่รองรับมีดังนี้

  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader

ดูข้อมูลเพิ่มเติมได้ที่บทบาทและสิทธิ์

allowFileDiscovery

boolean

สิทธิ์อนุญาตให้ค้นพบไฟล์ผ่านการค้นหาได้หรือไม่ โดยจะใช้ได้กับสิทธิ์ประเภท domain หรือ anyone เท่านั้น

domain

string

โดเมนที่สิทธิ์นี้อ้างอิง

expirationTime

string

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

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

boolean

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

view

string

ระบุมุมมองสำหรับสิทธิ์นี้ จะป้อนข้อมูลสำหรับสิทธิ์ที่เป็นของมุมมองเท่านั้น

ค่าที่รองรับคือ published และ metadata เท่านั้น

  • published: บทบาทของสิทธิ์คือ publishedReader
  • metadata: รายการจะแสดงในมุมมอง metadata เท่านั้น เนื่องจากรายการมีสิทธิ์เข้าถึงแบบจำกัด และขอบเขตมีสิทธิ์เข้าถึงระดับอ่านอย่างน้อยในระดับบน ระบบรองรับมุมมอง metadata ในโฟลเดอร์เท่านั้น

ดูข้อมูลเพิ่มเติมได้ที่ยอดดู

pendingOwner

boolean

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

inheritedPermissionsDisabled

boolean

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

เมธอด

create

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

delete

ลบสิทธิ์

get

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

list

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

update

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