REST Resource: permissions

ทรัพยากร: สิทธิ์

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

โดยค่าเริ่มต้น คำขอสิทธิ์จะแสดงเฉพาะช่องบางส่วนเท่านั้น ระบบจะแสดงผลประเภท รหัส ประเภท และบทบาทของสิทธิ์เสมอ หากต้องการเรียกข้อมูลฟิลด์ที่เฉพาะเจาะจง โปรดดูที่ https://developers.google.com/drive/api/guides/fields-parameter

เมธอดทรัพยากรบางรายการ (เช่น 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,
  "inheritedPermissionsDisabled": 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

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

published

และ

metadata

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

  • published

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

  • metadata

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

    metadata

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

pendingOwner

boolean

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

boolean

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

เมธอด

create

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

delete

 ลบสิทธิ์

get

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

list

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

update

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