หน้านี้ได้รับการแปลโดย Cloud Translation API

REST Resource: permissions

ทรัพยากร: สิทธิ์
- การแสดง JSON
เมธอด

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

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

โดยค่าเริ่มต้น คำขอสิทธิ์จะแสดงเฉพาะช่องบางส่วนเท่านั้น ระบบจะแสดงผลประเภท รหัส ประเภท และบทบาทของสิทธิ์เสมอ หากต้องการเรียกข้อมูลฟิลด์ที่เฉพาะเจาะจง โปรดดู 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 }

การแสดง 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` เอาต์พุตเท่านั้น สิทธิ์นี้รับช่วงมาหรือไม่ ระบบจะป้อนข้อมูลในช่องนี้เสมอ ฟิลด์นี้เป็นฟิลด์เอาต์พุตเท่านั้น
`photoLink`	`string` เอาต์พุตเท่านั้น ลิงก์ไปยังรูปโปรไฟล์ของผู้ใช้ (หากมี)
`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" เท่านั้น
`pendingOwner`	`boolean` บัญชีที่เชื่อมโยงกับสิทธิ์นี้เป็นเจ้าของที่รอดำเนินการหรือไม่ ระบบจะป้อนข้อมูลเฉพาะสำหรับสิทธิ์ประเภท `user` สำหรับไฟล์ที่ไม่ได้อยู่ในไดรฟ์ที่แชร์

เมธอด
`create`	สร้างสิทธิ์สำหรับไฟล์หรือไดรฟ์ที่แชร์
`delete`	ลบสิทธิ์
`get`	รับสิทธิ์ตามรหัส
`list`	แสดงสิทธิ์ของไฟล์หรือไดรฟ์ที่แชร์
`update`	อัปเดตสิทธิ์ด้วยความหมายของแพตช์

REST Resource: permissions

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

เมธอด

`create`

`delete`

`get`

`list`

`update`