Method: approvals.start

เริ่มการอนุมัติในไฟล์

คำขอ HTTP

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

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

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

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

string

ต้องระบุ รหัสของไฟล์ที่จะสร้างการอนุมัติ

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

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON
{
  "reviewerEmails": [
    string
  ],
  "dueTime": string,
  "lockFile": boolean,
  "message": string
}
ช่อง
reviewerEmails[]

string

ต้องระบุ อีเมลของผู้ใช้ที่ตั้งค่าให้ตรวจสอบการอนุมัติ

dueTime

string (Timestamp format)

ไม่บังคับ เวลาที่การอนุมัติครบกำหนด

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

lockFile

boolean

ไม่บังคับ จะล็อกไฟล์เมื่อเริ่มการอนุมัติหรือไม่

message

string

ไม่บังคับ ข้อความที่จะส่งถึงผู้ตรวจสอบเมื่อแจ้งคำขออนุมัติ

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Approval

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

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

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

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