Method: permissions.create

สร้างสิทธิ์สำหรับไฟล์หรือไดรฟ์ที่แชร์ ดูข้อมูลเพิ่มเติมได้ที่แชร์ไฟล์ โฟลเดอร์ และไดรฟ์

คำเตือน: ระบบไม่รองรับการดำเนินการเกี่ยวกับสิทธิ์พร้อมกันในไฟล์เดียวกัน โดยจะใช้เฉพาะการอัปเดตล่าสุดเท่านั้น

คำขอ HTTP

POST https://www.googleapis.com/drive/v3/files/{fileId}/permissions

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
fileId

string

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

พารามิเตอร์การค้นหา

พารามิเตอร์
emailMessage

string

ข้อความที่กำหนดเองแบบข้อความธรรมดาที่จะรวมไว้ในอีเมลแจ้งเตือน
enforceSingleParent
(deprecated)

boolean

เลิกใช้งานแล้ว: ดูรายละเอียดได้ที่ moveToNewOwnersRoot
moveToNewOwnersRoot

boolean

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

boolean

เลือกว่าจะส่งอีเมลแจ้งเตือนเมื่อแชร์กับผู้ใช้หรือกลุ่มหรือไม่ โดยค่าเริ่มต้น ระบบจะตั้งค่าเป็น true สำหรับผู้ใช้และกลุ่ม และไม่อนุญาตสำหรับคำขออื่นๆ โดยจะต้องไม่ปิดใช้สำหรับการโอนความเป็นเจ้าของ
supportsAllDrives

boolean

แอปพลิเคชันที่ขอรองรับทั้งไดรฟ์ของฉันและไดรฟ์ที่แชร์หรือไม่
supportsTeamDrives
(deprecated)

boolean

เลิกใช้งานแล้ว: โปรดใช้ supportsAllDrives แทน
transferOwnership

boolean

จะโอนความเป็นเจ้าของไปยังผู้ใช้ที่ระบุและดาวน์เกรดเจ้าของปัจจุบันเป็นผู้เขียนหรือไม่ ต้องระบุพารามิเตอร์นี้เพื่อเป็นการรับทราบผลข้างเคียง ดูข้อมูลเพิ่มเติมได้ที่โอนการเป็นเจ้าของไฟล์
useDomainAdminAccess

boolean

ส่งคำขอในฐานะผู้ดูแลระบบโดเมน

หากตั้งค่าเป็น true และหากตรงตามเงื่อนไขเพิ่มเติมต่อไปนี้ ผู้ขอจะได้รับสิทธิ์เข้าถึง

  1. พารามิเตอร์รหัสไฟล์หมายถึงไดรฟ์ที่แชร์
  2. ผู้ขอเป็นผู้ดูแลระบบของโดเมนที่ไดรฟ์ที่แชร์เป็นของโดเมนนั้น

ดูข้อมูลเพิ่มเติมได้ที่หัวข้อจัดการไดรฟ์ที่แชร์ในฐานะผู้ดูแลระบบโดเมน
enforceExpansiveAccess

boolean

คำขอควรบังคับใช้กฎการเข้าถึงแบบขยายหรือไม่

เนื้อความของคำขอ

เนื้อความของคำขอมีอินสแตนซ์ของ Permission

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Permission ที่สร้างขึ้นใหม่

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file

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