จัดการการอนุมัติ

เอกสารนี้อธิบายวิธีจัดการการอนุมัติใน Google Drive API

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

คุณสามารถสร้างและจัดการการอนุมัติเนื้อหาในไดรฟ์ได้ Google Drive API มี ทรัพยากร approvals สำหรับใช้กับการอนุมัติไฟล์ วิธีการของทรัพยากร approvals ใช้ได้กับรายการต่างๆ ภายในไดรฟ์, Google เอกสาร และเครื่องมือแก้ไขอื่นๆ ของ Google Workspace ผู้ตรวจสอบจะอนุมัติ ปฏิเสธ หรือแสดงความคิดเห็นเกี่ยวกับเอกสารได้โดยตรง

ก่อนเริ่มต้น

  1. ไฟล์ควรมีความสามารถ canStartApproval หากต้องการตรวจสอบความสามารถของไฟล์ ให้เรียกใช้เมธอด get ในทรัพยากร files ด้วยพารามิเตอร์เส้นทาง fileId และใช้ช่องความสามารถ canStartApproval ใน พารามิเตอร์ fields ดูข้อมูลเพิ่มเติมได้ที่ ทำความเข้าใจความสามารถของไฟล์

    ความสามารถ canStartApproval แบบบูลีนจะเป็น false ในกรณีต่อไปนี้

    • การตั้งค่าของผู้ดูแลระบบจำกัดการเข้าถึงฟีเจอร์
    • รุ่น Google Workspace ของคุณไม่มีสิทธิ์
    • ไฟล์เป็นของผู้ใช้ภายนอกโดเมน
    • ผู้ใช้ไม่มีสิทธิ์ role=writer ในไฟล์
  2. ตรวจสอบว่าคุณได้แชร์ไฟล์เป้าหมายกับผู้ตรวจสอบด้วยตนเอง เนื่องจากไดรฟ์จะไม่ดำเนินการนี้โดยอัตโนมัติ หากผู้ตรวจสอบไม่มีสิทธิ์เข้าถึงไฟล์ คำขออนุมัติจะสำเร็จ แต่ผู้ตรวจสอบจะไม่ได้รับการแจ้งเตือนหรือดูไฟล์ได้

แนวคิด

แนวคิดหลักต่อไปนี้เป็นรากฐานของการอนุมัติ

สถานะการอนุมัติ

เมื่อคุณขออนุมัติเอกสาร กระบวนการอนุมัติจะตรวจสอบว่าผู้ตรวจสอบทุกคนสามารถแสดงความคิดเห็นในเอกสารได้

ทรัพยากร 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 วงจรของการอนุมัติ

การอนุมัติจะผ่านสถานะต่างๆ หลายสถานะในระหว่างวงจร รูปที่ 1 แสดงขั้นตอนระดับสูงของวงจรการอนุมัติ

  1. เริ่มการอนุมัติ เรียกใช้ start เพื่อเริ่มคำขออนุมัติ จากนั้นระบบจะตั้งค่า status เป็น IN_PROGRESS

  2. การอนุมัติอยู่ระหว่างรอดำเนินการ ขณะที่การอนุมัติอยู่ระหว่างรอดำเนินการ (status ตั้งค่าเป็น IN_PROGRESS) ทั้งผู้เริ่มและผู้ตรวจสอบจะโต้ตอบกับการอนุมัติได้ โดย สามารถเพิ่ม comment ผู้เริ่ม สามารถ reassign ผู้ตรวจสอบ และผู้ตรวจสอบ อย่างน้อย 1 คนสามารถ approve คำขอ ได้

  3. การอนุมัติอยู่ในสถานะเสร็จสมบูรณ์ การอนุมัติจะเข้าสู่สถานะเสร็จสมบูรณ์ (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 3339
  • lockFile: บูลีนที่ระบุว่าจะล็อกไฟล์เมื่อเริ่มการอนุมัติหรือไม่ ซึ่งจะบล็อกไม่ให้ผู้ใช้แก้ไขไฟล์ในระหว่างกระบวนการอนุมัติ ผู้ใช้ที่มีสิทธิ์ role=writer จะนำการล็อกนี้ออกได้
  • message: ข้อความที่กำหนดเองซึ่งส่งถึงผู้ตรวจสอบ
  • fileContentChangeBehavior: ลักษณะการทำงานของการอนุมัติเมื่อเนื้อหาไฟล์มีการเปลี่ยนแปลง ค่าที่รองรับมีดังนี้
    • RESET_APPROVAL: (ค่าเริ่มต้น) รีเซ็ตการตอบกลับ APPROVED ของผู้ตรวจสอบเป็น NO_RESPONSE เมื่อเนื้อหามีการเปลี่ยนแปลงขณะที่การอนุมัติอยู่ระหว่างดำเนินการ ระบบจะล็อกไฟล์เมื่อการอนุมัติเสร็จสมบูรณ์โดยมีสถานะเป็น APPROVED
    • NO_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 ของแอป