เอกสารนี้อธิบายวิธีจัดการการอนุมัติใน Google Drive API
ผู้ใช้จะส่งเอกสารใน Google ไดรฟ์ผ่านกระบวนการอนุมัติอย่างเป็นทางการได้ คุณสามารถใช้กระบวนการนี้เพื่อขออนุมัติการตรวจสอบสัญญาหรือเอกสารอย่างเป็นทางการก่อนเผยแพร่ การอนุมัติจะติดตามสถานะของการตรวจสอบ (เช่น อยู่ระหว่างดำเนินการ ได้รับอนุมัติ หรือถูกปฏิเสธ) และผู้ตรวจสอบที่เกี่ยวข้อง การอนุมัติเป็นวิธีที่ยอดเยี่ยมในการตรวจสอบความถูกต้องของเนื้อหาและเก็บประวัติผู้ตรวจสอบ
คุณสามารถสร้างและจัดการการอนุมัติเนื้อหาในไดรฟ์ได้ Google Drive API มี
ทรัพยากร approvals สำหรับใช้กับการอนุมัติไฟล์
วิธีการของทรัพยากร approvals ใช้ได้กับรายการต่างๆ ภายในไดรฟ์, Google เอกสาร และเครื่องมือแก้ไขอื่นๆ ของ Google Workspace ผู้ตรวจสอบจะอนุมัติ ปฏิเสธ หรือแสดงความคิดเห็นเกี่ยวกับเอกสารได้โดยตรง
ก่อนเริ่มต้น
ไฟล์ควรมีความสามารถ
canStartApprovalหากต้องการตรวจสอบความสามารถของไฟล์ ให้เรียกใช้เมธอดgetในทรัพยากรfilesด้วยพารามิเตอร์เส้นทางfileIdและใช้ช่องความสามารถcanStartApprovalใน พารามิเตอร์fieldsดูข้อมูลเพิ่มเติมได้ที่ ทำความเข้าใจความสามารถของไฟล์ความสามารถ
canStartApprovalแบบบูลีนจะเป็นfalseในกรณีต่อไปนี้- การตั้งค่าของผู้ดูแลระบบจำกัดการเข้าถึงฟีเจอร์
- รุ่น Google Workspace ของคุณไม่มีสิทธิ์
- ไฟล์เป็นของผู้ใช้ภายนอกโดเมน
- ผู้ใช้ไม่มีสิทธิ์
role=writerในไฟล์
ตรวจสอบว่าคุณได้แชร์ไฟล์เป้าหมายกับผู้ตรวจสอบด้วยตนเอง เนื่องจากไดรฟ์จะไม่ดำเนินการนี้โดยอัตโนมัติ หากผู้ตรวจสอบไม่มีสิทธิ์เข้าถึงไฟล์ คำขออนุมัติจะสำเร็จ แต่ผู้ตรวจสอบจะไม่ได้รับการแจ้งเตือนหรือดูไฟล์ได้
แนวคิด
แนวคิดหลักต่อไปนี้เป็นรากฐานของการอนุมัติ
สถานะการอนุมัติ
เมื่อคุณขออนุมัติเอกสาร กระบวนการอนุมัติจะตรวจสอบว่าผู้ตรวจสอบทุกคนสามารถแสดงความคิดเห็นในเอกสารได้
ทรัพยากร approvals มีออบเจ็กต์
Status ที่แสดงรายละเอียดสถานะ
การอนุมัติเมื่อมีการขอทรัพยากร นอกจากนี้ยังมีออบเจ็กต์
ReviewerResponse ที่
แสดงรายละเอียดการตอบกลับการอนุมัติที่ทำโดยผู้ตรวจสอบที่เฉพาะเจาะจง การตอบกลับของผู้ตรวจสอบแต่ละคนจะแสดงด้วย
Responseออบเจ็กต์
ลักษณะการทำงานของการอนุมัติเมื่อมีการเปลี่ยนแปลงเนื้อหาไฟล์ขณะที่การอนุมัติ
Status เป็น IN_PROGRESS จะกำหนดโดยช่อง fileContentChangeBehavior ของทรัพยากร
approvals คุณสามารถใช้ลักษณะการทำงานต่อไปนี้ได้
RESET_APPROVAL: กระบวนการอนุมัติจะตรวจสอบว่าผู้ตรวจสอบทุกคนอนุมัติเนื้อหาเวอร์ชันเดียวกัน หากมีการแก้ไขไฟล์หลังจากที่ผู้ตรวจสอบอนุมัติคำขอแล้ว แต่ก่อนที่คำขอจะเสร็จสมบูรณ์ ระบบจะรีเซ็ตการอนุมัติของผู้ตรวจสอบ (การตอบกลับจะเปลี่ยนกลับเป็นNO_RESPONSE) และผู้ตรวจสอบจะต้องอนุมัติเวอร์ชันใหม่ เมื่อการอนุมัติมีสถานะเป็นAPPROVEDระบบจะล็อกไฟล์เพื่อป้องกันการแก้ไขเพิ่มเติม การแก้ไขเนื้อหาเพิ่มเติมหลังจากการอนุมัติขั้นสุดท้ายจะทำให้แบนเนอร์ปรากฏในเอกสารเพื่อระบุว่าเวอร์ชันปัจจุบันแตกต่างจากเวอร์ชันที่ได้รับอนุมัติ นี่คือลักษณะการทำงานเริ่มต้นNO_APPROVAL_ACTION: การแก้ไขเนื้อหาไฟล์จะไม่รีเซ็ตการตัดสินใจของผู้ตรวจสอบขณะที่การอนุมัติอยู่ระหว่างรอดำเนินการ นอกจากนี้ ระบบจะไม่ล็อกไฟล์เมื่อได้รับการอนุมัติขั้นสุดท้าย ผู้ตรวจสอบยังสามารถรีเซ็ตการตัดสินใจAPPROVEDของตนเองกลับเป็นสถานะรอดำเนินการ (การตอบกลับจะเปลี่ยนกลับเป็นNO_RESPONSE) ได้ทุกเมื่อก่อนที่การอนุมัติจะเสร็จสมบูรณ์
เมื่อการอนุมัติเสร็จสมบูรณ์แล้ว ลักษณะการทำงานนี้จะไม่มีผลอีกต่อไป
ทุกการดำเนินการในกระบวนการอนุมัติจะสร้างการแจ้งเตือนทางอีเมลที่ส่งไปยังผู้เริ่ม (ผู้ใช้ที่ขออนุมัติ) และผู้ตรวจสอบทุกคน และจะเพิ่มลงในบันทึกกิจกรรมการอนุมัติด้วย
ผู้ตรวจสอบทุกคนต้องอนุมัติการอนุมัติ ผู้ตรวจสอบที่ปฏิเสธการอนุมัติจะตั้งค่าสถานะเสร็จสมบูรณ์เป็น DECLINED
หลังจากที่การอนุมัติเสร็จสมบูรณ์แล้ว (สถานะเป็น APPROVED, CANCELLED หรือ DECLINED) การอนุมัติจะยังคงอยู่ในสถานะเสร็จสมบูรณ์และผู้เริ่มหรือผู้ตรวจสอบจะโต้ตอบกับการอนุมัติไม่ได้ คุณสามารถเพิ่มความคิดเห็นในการอนุมัติที่เสร็จสมบูรณ์แล้วได้ตราบใดที่ไม่มีการอนุมัติไฟล์ที่มีสถานะเป็น IN_PROGRESS
วงจรของการอนุมัติ
การอนุมัติจะผ่านสถานะต่างๆ หลายสถานะในระหว่างวงจร รูปที่ 1 แสดงขั้นตอนระดับสูงของวงจรการอนุมัติ
เริ่มการอนุมัติ เรียกใช้
startเพื่อเริ่มคำขออนุมัติ จากนั้นระบบจะตั้งค่าstatusเป็นIN_PROGRESSการอนุมัติอยู่ระหว่างรอดำเนินการ ขณะที่การอนุมัติอยู่ระหว่างรอดำเนินการ (
statusตั้งค่าเป็นIN_PROGRESS) ทั้งผู้เริ่มและผู้ตรวจสอบจะโต้ตอบกับการอนุมัติได้ โดย สามารถเพิ่มcommentผู้เริ่ม สามารถreassignผู้ตรวจสอบ และผู้ตรวจสอบ อย่างน้อย 1 คนสามารถapproveคำขอ ได้การอนุมัติอยู่ในสถานะเสร็จสมบูรณ์ การอนุมัติจะเข้าสู่สถานะเสร็จสมบูรณ์ (
statusตั้งค่าเป็นAPPROVED,CANCELLEDหรือDECLINED) เมื่อผู้ตรวจสอบทุกคน อนุมัติคำขอ ผู้เริ่มเลือกที่จะcancelคำขอ หรือหากผู้ตรวจสอบเลือก ที่จะdeclineคำขอ
ใช้พารามิเตอร์ `fields`
หากต้องการดึงข้อมูลรายละเอียดการอนุมัติ คุณต้องระบุช่องที่ต้องการอย่างชัดเจน
โดยใช้ fields พารามิเตอร์
ระบบ
กับเมธอดใดก็ได้ของทรัพยากร approvals เมธอดของทรัพยากร approvals จะไม่แสดงผลชุดช่องเริ่มต้นเมื่อละเว้นพารามิเตอร์ fields ซึ่งแตกต่างจากทรัพยากรอื่นๆ ดูข้อมูลเพิ่มเติมได้ที่ แสดงผลช่องที่เฉพาะเจาะจง
เริ่มและจัดการการอนุมัติ
คุณสามารถใช้ทรัพยากร approvals เพื่อเริ่ม
และจัดการการอนุมัติโดยใช้ Drive API เมธอดเหล่านี้ใช้ได้กับขอบเขต OAuth 2.0 Drive API ที่มีอยู่ทั้งหมดซึ่งอนุญาตให้เขียนข้อมูลเมตาของไฟล์ ดูข้อมูลเพิ่มเติมได้ที่ เลือกขอบเขต Google Drive API
เริ่มการอนุมัติ
หากต้องการเริ่มการอนุมัติใหม่ในไฟล์ ให้ใช้เมธอด
start ในทรัพยากร approvals และใส่พารามิเตอร์เส้นทาง fileId
เนื้อหาของคำขอประกอบด้วย
ช่อง reviewerEmails ที่จำเป็น ซึ่งเป็นอาร์เรย์ของสตริงที่มี
อีเมลของผู้ตรวจสอบที่ได้รับมอบหมายให้ตรวจสอบไฟล์ อีเมลของผู้ตรวจสอบแต่ละคนต้องเชื่อมโยงกับบัญชี Google ไม่เช่นนั้นคำขอจะล้มเหลว
นอกจากนี้ยังมีช่องที่ไม่บังคับ 4 ช่อง ได้แก่
dueTime: กำหนดเวลาสำหรับการอนุมัติในรูปแบบ RFC 3339lockFile: บูลีนที่ระบุว่าจะล็อกไฟล์เมื่อเริ่มการอนุมัติหรือไม่ ซึ่งจะบล็อกไม่ให้ผู้ใช้แก้ไขไฟล์ในระหว่างกระบวนการอนุมัติ ผู้ใช้ที่มีสิทธิ์role=writerจะนำการล็อกนี้ออกได้message: ข้อความที่กำหนดเองซึ่งส่งถึงผู้ตรวจสอบfileContentChangeBehavior: ลักษณะการทำงานของการอนุมัติเมื่อเนื้อหาไฟล์มีการเปลี่ยนแปลง ค่าที่รองรับมีดังนี้RESET_APPROVAL: (ค่าเริ่มต้น) รีเซ็ตการตอบกลับAPPROVEDของผู้ตรวจสอบเป็นNO_RESPONSEเมื่อเนื้อหามีการเปลี่ยนแปลงขณะที่การอนุมัติอยู่ระหว่างดำเนินการ ระบบจะล็อกไฟล์เมื่อการอนุมัติเสร็จสมบูรณ์โดยมีสถานะเป็นAPPROVEDNO_APPROVAL_ACTION: ไม่รีเซ็ตการตอบกลับของผู้ตรวจสอบเมื่อเนื้อหามีการเปลี่ยนแปลง และไม่ล็อกไฟล์เมื่อการอนุมัติเสร็จสมบูรณ์
เนื้อหาการตอบกลับมีอินสแตนซ์ของทรัพยากร approvals และมี
ช่อง
initiator ซึ่งเป็นผู้ใช้ที่ขออนุมัติ ระบบจะตั้งค่าการอนุมัติ Status เป็น IN_PROGRESS
หากมีการอนุมัติที่มีอยู่โดยมี Status เป็น IN_PROGRESS เมธอด start จะล้มเหลว คุณจะเริ่มการอนุมัติได้ก็ต่อเมื่อไม่มีการอนุมัติไฟล์อยู่ หรือหากการอนุมัติที่มีอยู่เสร็จสมบูรณ์แล้ว (สถานะเป็น APPROVED, CANCELLED หรือ DECLINED)
curl
curl -X POST \
'https://www.googleapis.com/drive/v3/files/FILE_ID/approvals:start' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"reviewerEmails": [
"reviewer1@example.com",
"reviewer2@example.com"
],
"dueTime": "2026-04-01T15:01:23Z",
"lockFile": true,
"message": "Please review this file for approval.",
"fileContentChangeBehavior": "RESET_APPROVAL"
}'
แทนที่ค่าต่อไปนี้
- FILE_ID: รหัสของไฟล์ที่อยู่ระหว่างการอนุมัติ
- ACCESS_TOKEN: โทเค็น OAuth 2.0 ของแอป
แสดงความคิดเห็นในการอนุมัติ
หากต้องการแสดงความคิดเห็นในการอนุมัติ ให้ใช้เมธอด
comment ในทรัพยากร approvals และใส่พารามิเตอร์เส้นทาง fileId และ approvalId
เนื้อหาของคำขอประกอบด้วย
ช่อง message ที่จำเป็น ซึ่งเป็นสตริงที่มีความคิดเห็นที่คุณต้องการ
เพิ่มในการอนุมัติ
เนื้อหาการตอบกลับมีอินสแตนซ์ของทรัพยากร approvals ระบบจะส่งข้อความไปยังผู้เริ่มและผู้ตรวจสอบการอนุมัติเป็นการแจ้งเตือน และจะรวมข้อความไว้ในบันทึกกิจกรรมการอนุมัติด้วย
curl
curl -X POST \
'https://www.googleapis.com/drive/v3/files/FILE_ID/approvals/APPROVAL_ID:comment' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"message": "The required comment on the approval."
}'
แทนที่ค่าต่อไปนี้
- FILE_ID: รหัสของไฟล์ที่อยู่ระหว่างการอนุมัติ
- APPROVAL_ID: รหัสของการอนุมัติ
- ACCESS_TOKEN: โทเค็น OAuth 2.0 ของแอป
มอบหมายผู้ตรวจสอบใหม่ในการอนุมัติ
หากต้องการมอบหมายผู้ตรวจสอบใหม่ในการอนุมัติ ให้ใช้เมธอด
reassign ในทรัพยากร approvals และใส่พารามิเตอร์เส้นทาง fileId และ approvalId
เมธอด reassign ช่วยให้ผู้เริ่มการอนุมัติ (หรือผู้ใช้ที่มีสิทธิ์
role=writer ) เพิ่มหรือแทนที่ผู้ตรวจสอบในออบเจ็กต์
ReviewerResponse ของ
ทรัพยากร approvals ได้ ผู้ใช้ที่มีสิทธิ์ role=reader จะมอบหมายการอนุมัติที่มอบหมายให้ตนเองใหม่ได้เท่านั้น ซึ่งจะช่วยให้ผู้ใช้มอบหมายคำขอใหม่ให้ผู้อื่นที่เป็นผู้ตรวจสอบที่มีความสามารถมากกว่าได้
คุณจะมอบหมายผู้ตรวจสอบใหม่ได้ก็ต่อเมื่อ
Status เป็น IN_PROGRESS และช่อง
response
สำหรับผู้ตรวจสอบที่ได้รับมอบหมายใหม่ตั้งค่าเป็น NO_RESPONSE
โปรดทราบว่าคุณไม่สามารถนำผู้ตรวจสอบออกจากการอนุมัติ หากต้องการนำผู้ตรวจสอบออก คุณต้องยกเลิกการอนุมัติและเริ่มการอนุมัติใหม่
เนื้อหาของคำขอประกอบด้วยช่อง addReviewers และ replaceReviewers ที่ไม่บังคับ แต่ละช่องมีออบเจ็กต์ที่ซ้ำได้สำหรับAddReviewerและReplaceReviewerซึ่งแต่ละออบเจ็กต์มีผู้ตรวจสอบคนเดียวที่จะเพิ่มหรือผู้ตรวจสอบ 2 คนที่จะแทนที่
นอกจากนี้ คุณยังเพิ่มช่อง message ที่ไม่บังคับซึ่งมีความคิดเห็นที่คุณต้องการส่งถึงผู้ตรวจสอบใหม่ได้ด้วย
เนื้อหาการตอบกลับมีอินสแตนซ์ของทรัพยากร approvals ระบบจะส่งข้อความไปยังผู้ตรวจสอบใหม่เป็นการแจ้งเตือน และจะรวมข้อความไว้ในบันทึกกิจกรรมการอนุมัติด้วย
curl
curl -X POST \
'https://www.googleapis.com/drive/v3/files/FILE_ID/approvals/APPROVAL_ID:reassign' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"addReviewers": [
{
"addedReviewerEmail": "new_reviewer@example.com"
}
],
"replaceReviewers": [
{
"addedReviewerEmail": "replacement_reviewer@example.com",
"removedReviewerEmail": "old_reviewer@example.com"
}
],
"message": "Reassigning reviewers for this approval request."
}'
แทนที่ค่าต่อไปนี้
- FILE_ID: รหัสของไฟล์ที่อยู่ระหว่างการอนุมัติ
- APPROVAL_ID: รหัสของการอนุมัติ
- ACCESS_TOKEN: โทเค็น OAuth 2.0 ของแอป
ยกเลิกการอนุมัติ
หากต้องการยกเลิกการอนุมัติ ให้ใช้cancel
เมธอดในapprovals ทรัพยากร และใส่
พารามิเตอร์เส้นทางfileId และapprovalId
เมธอด cancel สามารถเรียกใช้ได้โดยผู้เริ่มการอนุมัติ (หรือผู้ใช้ที่มีสิทธิ์
role=writer ) เท่านั้น ขณะที่
Status ของการอนุมัติเป็น IN_PROGRESS
เนื้อหาของคำขอประกอบด้วย
ช่องที่ไม่บังคับ message ซึ่งเป็นสตริงที่มีข้อความที่จะแนบไปกับการยกเลิกการอนุมัติ
เนื้อหาการตอบกลับมีอินสแตนซ์ของทรัพยากร approvals ระบบจะส่งข้อความเป็นการแจ้งเตือน และจะรวมข้อความไว้ในบันทึกกิจกรรมการอนุมัติด้วย
ระบบจะตั้งค่า Status ของการอนุมัติเป็น CANCELLED และการอนุมัติจะอยู่ในสถานะเสร็จสมบูรณ์
curl
curl -X POST \
'https://www.googleapis.com/drive/v3/files/FILE_ID/approvals/APPROVAL_ID:cancel' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"message": "The optional reason for cancelling this approval request."
}'
แทนที่ค่าต่อไปนี้
- FILE_ID: รหัสของไฟล์ที่อยู่ระหว่างการอนุมัติ
- APPROVAL_ID: รหัสของการอนุมัติ
- ACCESS_TOKEN: โทเค็น OAuth 2.0 ของแอป
ปฏิเสธการอนุมัติ
หากต้องการปฏิเสธการอนุมัติ ให้ใช้เมธอด
decline ในทรัพยากร approvals และใส่พารามิเตอร์เส้นทาง fileId และ approvalId
เมธอด decline สามารถเรียกใช้ได้ขณะที่ Status ของการอนุมัติเป็น IN_PROGRESS
เนื้อหาของคำขอประกอบด้วย
ช่องที่ไม่บังคับ message ซึ่งเป็นสตริงที่มีข้อความที่จะแนบไปกับการปฏิเสธการอนุมัติ
เนื้อหาการตอบกลับมีอินสแตนซ์ของทรัพยากร approvals ระบบจะส่งข้อความเป็นการแจ้งเตือน และจะรวมข้อความไว้ในบันทึกกิจกรรมการอนุมัติด้วย
ช่อง response
ของออบเจ็กต์ ReviewerResponse
ของผู้ใช้ที่ส่งคำขอจะตั้งค่าเป็น DECLINED นอกจากนี้ ระบบจะตั้งค่า Status ของการอนุมัติเป็น DECLINED และการอนุมัติจะอยู่ในสถานะเสร็จสมบูรณ์
curl
curl -X POST \
'https://www.googleapis.com/drive/v3/files/FILE_ID/approvals/APPROVAL_ID:decline' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"message": "The optional reason for declining this approval request."
}'
แทนที่ค่าต่อไปนี้
- FILE_ID: รหัสของไฟล์ที่อยู่ระหว่างการอนุมัติ
- APPROVAL_ID: รหัสของการอนุมัติ
- ACCESS_TOKEN: โทเค็น OAuth 2.0 ของแอป
อนุมัติการอนุมัติ
หากต้องการอนุมัติการอนุมัติ ให้ใช้เมธอด
approve ในทรัพยากร approvals และใส่พารามิเตอร์เส้นทาง fileId และ approvalId
เมธอด approve สามารถเรียกใช้ได้ขณะที่ Status ของการอนุมัติเป็น IN_PROGRESS
เนื้อหาของคำขอประกอบด้วยช่อง message ที่ไม่บังคับ ซึ่งเป็นสตริงที่มีข้อความที่จะแนบไปกับการอนุมัติ
เนื้อหาการตอบกลับมีอินสแตนซ์ของทรัพยากร approvals ระบบจะส่งข้อความเป็นการแจ้งเตือน และจะรวมข้อความไว้ในบันทึกกิจกรรมการอนุมัติด้วย
ช่อง response
ของออบเจ็กต์ ReviewerResponse
ของผู้ใช้ที่ส่งคำขอจะตั้งค่าเป็น APPROVED นอกจากนี้ หากนี่เป็นการตอบกลับสุดท้ายของผู้ตรวจสอบที่จำเป็น ระบบจะตั้งค่า Status ของการอนุมัติเป็น APPROVED และการอนุมัติจะอยู่ในสถานะเสร็จสมบูรณ์
curl
curl -X POST \
'https://www.googleapis.com/drive/v3/files/FILE_ID/approvals/APPROVAL_ID:approve' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"message": "The optional reason for approving this approval request."
}'
แทนที่ค่าต่อไปนี้
- FILE_ID: รหัสของไฟล์ที่อยู่ระหว่างการอนุมัติ
- APPROVAL_ID: รหัสของการอนุมัติ
- ACCESS_TOKEN: โทเค็น OAuth 2.0 ของแอป
ค้นหาการอนุมัติที่มีอยู่
คุณยังใช้ทรัพยากร approvals เพื่อรับ
และแสดงรายการสถานะการอนุมัติโดยใช้ Drive API ได้ด้วย
หากต้องการดูการอนุมัติในไฟล์ คุณต้องมีสิทธิ์อ่านข้อมูลเมตาของไฟล์ ดูข้อมูลเพิ่มเติมได้ที่ บทบาทและ สิทธิ์
รับการอนุมัติ
หากต้องการรับการอนุมัติในไฟล์ ให้ใช้ get
เมธอดในทรัพยากร approvals ด้วยพารามิเตอร์เส้นทาง fileId และ approvalId
หากไม่ทราบรหัสการอนุมัติ คุณสามารถ แสดงรายการ
การอนุมัติ โดยใช้เมธอด list
เนื้อหาการตอบกลับมีอินสแตนซ์ของทรัพยากร approvals
curl
curl -X GET \
'https://www.googleapis.com/drive/v3/files/FILE_ID/approvals/APPROVAL_ID' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Accept: application/json'
แทนที่ค่าต่อไปนี้
- FILE_ID: รหัสของไฟล์ที่อยู่ระหว่างการอนุมัติ
- APPROVAL_ID: รหัสของการอนุมัติ
- ACCESS_TOKEN: โทเค็น OAuth 2.0 ของแอป
แสดงรายการการอนุมัติ
หากต้องการแสดงรายการการอนุมัติในไฟล์ ให้เรียกใช้เมธอด
list ในทรัพยากร approvals และใส่พารามิเตอร์เส้นทาง fileId
เนื้อหาการตอบกลับประกอบด้วย
รายการการอนุมัติในไฟล์ ช่อง
items
มีข้อมูลเกี่ยวกับการอนุมัติแต่ละรายการในรูปแบบทรัพยากร approvals
นอกจากนี้ คุณยังส่งพารามิเตอร์การค้นหาต่อไปนี้เพื่อปรับแต่งการแบ่งหน้าหรือกรองการอนุมัติได้ด้วย
pageSize: จำนวนการอนุมัติสูงสุดที่จะแสดงผลต่อหน้า หากไม่ตั้งค่าpageSizeเซิร์ฟเวอร์จะแสดงผลการอนุมัติสูงสุด 100 รายการpageToken: โทเค็นหน้าซึ่งได้รับจากการเรียกใช้รายการก่อนหน้า โทเค็นนี้ใช้เพื่อดึงข้อมูลหน้าถัดไป คุณควรตั้งค่าเป็นค่าnextPageTokenจากการตอบกลับก่อนหน้า
curl
curl -X GET \
'https://www.googleapis.com/drive/v3/files/FILE_ID/approvals?pageSize=10&fields=nextPageToken,items(approvalId,status)' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Accept: application/json'
แทนที่ค่าต่อไปนี้
- FILE_ID: รหัสของไฟล์ที่อยู่ระหว่างการอนุมัติ
- ACCESS_TOKEN: โทเค็น OAuth 2.0 ของแอป