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

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

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

เลิกใช้งานแล้ว: ให้ใช้ supportsAllDrives แทน

transferOwnership

boolean

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

useDomainAdminAccess

boolean

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

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

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

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

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

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

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

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