ขีดจำกัดการใช้งาน

ตั้งแต่วันที่ 1 พฤษภาคม 2026 เป็นต้นไป เราได้อัปเดตขีดจำกัดการใช้งานสำหรับ API นี้ โปรเจ็กต์ Google Cloud ที่ใช้ API นี้ระหว่างเดือนพฤศจิกายน 2025 ถึงเมษายน 2026 จะยังคงใช้โควต้าการใช้งานที่ตั้งไว้ก่อนหน้านี้ต่อไป โปรเจ็กต์ที่อยู่ในระบบคลาวด์ซึ่งสร้างขึ้นตั้งแต่วันที่ 1 พฤษภาคม 2026 เป็นต้นไปจะขึ้นอยู่กับโควต้า API ใหม่

ดูข้อมูลเพิ่มเติม รวมถึงไทม์ไลน์ได้ที่โมเดลมาตรฐานของ Google Workspace สำหรับเครื่องมือและ API ของ Agent

โปรดดูประกาศฉบับเต็มที่หัวข้อเครื่องมือ Agent และการอัปเดตความปลอดภัยสำหรับนักพัฒนาแอป Google Workspace

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

ขีดจำกัดจะกำหนดในรูปของหน่วยโควต้า ซึ่งเป็นหน่วยวัดนามธรรมที่แสดงถึงการใช้ทรัพยากร Google ไดรฟ์

โควต้า Drive API

โควต้าที่บังคับใช้มี 3 ประเภท ดังนี้

• ต่อนาทีต่อโปรเจ็กต์: จำนวนหน่วยโควต้าที่โปรเจ็กต์ Google Cloud ของคุณใช้ได้ใน 1 นาที

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

• ต่อวันต่อโปรเจ็กต์: กำหนดจำนวนไบต์สูงสุดที่โปรเจ็กต์ Google Cloud สามารถส่งออกได้ภายในระยะเวลา 24 ชั่วโมงก่อนที่จะมีการเรียกเก็บเงิน

ตารางต่อไปนี้แสดงรายละเอียดขีดจำกัดเหล่านี้

ประเภทขีดจำกัดการใช้งาน	ขีดจำกัด
ต่อนาทีต่อโปรเจ็กต์	1,000,000 หน่วยโควต้า
ต่อนาทีต่อผู้ใช้ต่อโปรเจ็กต์	โควต้า 325,000 หน่วย
ต่อวันต่อโปรเจ็กต์	1 TB

หากใช้เกินโควต้า คุณจะได้รับการตอบกลับเป็นรหัสสถานะ HTTP 403: User rate limit exceeded การตรวจสอบการจำกัดอัตราคำขอเพิ่มเติมในแบ็กเอนด์ของไดรฟ์อาจสร้างการตอบกลับ 429: Rate limit exceeded ด้วย หากเกิดกรณีเช่นนี้ คุณควรใช้อัลกอริทึม Exponential Backoff แล้วลองอีกครั้งในภายหลัง

เกณฑ์การเรียกเก็บเงินรายวัน

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

การใช้งานที่ต่ำกว่าเกณฑ์นี้จะไม่ทำให้เกิดค่าใช้จ่ายเพิ่มเติม และระบบจะไม่เรียกเก็บเงินจากบัญชี Google Cloud ของคุณ เราจะแชร์รายละเอียดการเรียกเก็บเงินทั้งหมดในภายหลังในปี 2026 โดยจะแจ้งให้ทราบล่วงหน้าอย่างน้อย 90 วันก่อนที่การเปลี่ยนแปลงจะมีผล

คุณไม่สามารถขอเพิ่มเกณฑ์รายวันนี้ได้

ตารางต่อไปนี้แสดงรายละเอียดขีดจำกัด

ประเภทเกณฑ์การชำระเงิน	ขีดจำกัด
ต่อวันต่อโปรเจ็กต์	โควต้า 400,000,000 หน่วย

ดูข้อมูลเพิ่มเติมได้ที่โมเดลมาตรฐานของ Google Workspace สำหรับเครื่องมือและ API ของ Agent

ค่าใช้จ่ายหน่วยโควต้าต่อเมธอด

จำนวนหน่วยโควต้าที่ใช้ต่อคำขอจะแตกต่างกันไปตามเมธอดที่เรียกใช้ ดังที่อธิบายไว้ในตารางต่อไปนี้

เมธอดการอ่าน (โควต้า 5 หน่วย)

วิธีการ
drive.about.get
drive.accessproposals.get
drive.apps.get
drive.approvals.get
drive.changes.get
drive.children.get
drive.comments.get
drive.drives.get
drive.files.get (without alt=media)
drive.parents.get
drive.permissions.get
drive.properties.get
drive.replies.get
drive.revisions.get (without alt=media)
drive.teamdrives.get

เมธอด List (100 หน่วยโควต้า)

วิธีการ
drive.accessproposals.list
drive.apps.list
drive.changes.list, drive.changes.watch
drive.children.list
drive.comments.list
drive.drives.list
drive.files.list, drive.files.watch
drive.parents.list
drive.permissions.list
drive.properties.list
drive.replies.list
drive.revisions.list
drive.teamdrives.list

เมธอด Edit (50 หน่วยโควต้า)

วิธีการ
drive.approvals.decline
drive.children.delete, drive.children.insert
drive.comments.create drive.comments.delete drive.comments.insert drive.comments.patch drive.comments.update
drive.drives.create drive.drives.delete drive.drives.hide drive.drives.insert drive.drives.unhide drive.drives.update
drive.files.copy, drive.files.create, drive.files.delete, drive.files.emptyTrash, drive.files.insert, drive.files.modifyLabels, drive.files.patch, drive.files.touch, drive.files.trash, drive.files.untrash, drive.files.update
drive.parents.delete, drive.parents.insert
drive.permissions.create drive.permissions.delete drive.permissions.insert drive.permissions.patch drive.permissions.update
drive.properties.delete, drive.properties.insert, drive.properties.patch, drive.properties.update
drive.replies.create drive.replies.delete drive.replies.insert drive.replies.patch drive.replies.update
drive.revisions.delete, drive.revisions.patch, drive.revisions.update
drive.teamdrives.create, drive.teamdrives.delete, drive.teamdrives.insert, drive.teamdrives.update

เมธอดการดาวน์โหลด (200 หน่วยโควต้า)

วิธีการ
drive.files.download, drive.files.export, drive.files.get (with alt=media)
drive.revisions.get (with alt=media)

เมธอดอื่นๆ (5 หน่วยโควต้า)

วิธีการ
drive.changes.getStartPageToken
drive.channels.stop
drive.files.generateCseToken, drive.files.generateIds, drive.files.listLabels
drive.operations.get
drive.permissions.getIdForEmail

ข้อบังคับเพิ่มเติม

ระบบจะบังคับใช้ข้อจำกัดต่อไปนี้เมื่อทำงานกับ Drive API

• ผู้ใช้ Google Workspace จะอัปโหลดข้อมูลได้เพียง 750 GB ต่อวันระหว่างไดรฟ์ของฉันและไดรฟ์ที่แชร์ทั้งหมด โดยขีดจำกัดนี้จะมีผลกับการคัดลอกด้วย

• ผู้ใช้ที่ใช้พื้นที่ถึงขีดจำกัด 750 GB หรืออัปโหลดไฟล์ที่มีขนาดใหญ่กว่า 750 GB จะอัปโหลดหรือคัดลอกไฟล์เพิ่มไม่ได้จนกว่าจะผ่านไป 24 ชั่วโมง

• ขนาดไฟล์สูงสุดที่ผู้ใช้อัปโหลดได้คือ 5 TB โดยจะมีเฉพาะไฟล์แรกที่เกินขีดจำกัดเท่านั้นที่จะอัปโหลดจนเสร็จสิ้น ขนาดไฟล์สูงสุดที่ผู้ใช้คัดลอกได้คือ 750 GB

• การแจ้งเตือนที่ส่งไปยังอีเมลที่ระบุเมื่อเปิดช่องทางการแจ้งเตือนจะไม่นับรวมในโควต้าของคุณ อย่างไรก็ตาม การเรียกใช้เมธอด changes.watch, channels.stop และ files.watch จะนับรวมในโควต้าของคุณ

• หากคุณยังคงอยู่ภายในโควต้าต่อนาที คุณจะส่งคำขอได้ไม่จำกัดจำนวนต่อวัน

• คุณอาจมีขีดจำกัดพื้นที่เก็บข้อมูล Google ไดรฟ์เพิ่มเติม ทั้งนี้ขึ้นอยู่กับประเภทบัญชี Google Workspace ที่ใช้งาน

แก้ไขข้อผิดพลาดเกี่ยวกับโควต้าตามเวลา

สำหรับข้อผิดพลาดที่อิงตามเวลาทั้งหมด (คำขอสูงสุด N รายการต่อ X นาที) เราขอแนะนำให้โค้ดของคุณตรวจจับข้อยกเว้นและใช้ Truncated Exponential Backoff เพื่อให้แน่ใจว่าอุปกรณ์จะไม่สร้างภาระงานมากเกินไป

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

ตัวอย่างอัลกอริทึม

อัลกอริทึม Exponential Backoff จะลองส่งคำขอซ้ำแบบทวีคูณ โดยเพิ่มเวลารอระหว่างการลองใหม่จนถึงเวลา Backoff สูงสุด เช่น

1. ส่งคำขอไปยัง Google Drive API
2. หากคำขอล้มเหลว ให้รอ 1 + random_number_milliseconds แล้วลองส่งคำขออีกครั้ง
3. หากคำขอล้มเหลว ให้รอ 2 + random_number_milliseconds แล้วลองส่งคำขออีกครั้ง
4. หากคำขอล้มเหลว ให้รอ 4 + random_number_milliseconds แล้วลองส่งคำขออีกครั้ง
5. และต่อไปเรื่อยๆ จนถึงครั้งที่ maximum_backoff
6. รอต่อไปและลองใหม่จนกว่าจะถึงจำนวนครั้งสูงสุดที่อนุญาต แต่ไม่ต้องเพิ่มระยะเวลารอระหว่างการลองใหม่แต่ละครั้ง

โดยที่

• เวลารอคือ min(((2^n)+random_number_milliseconds), maximum_backoff) โดย n จะเพิ่มขึ้น 1 สำหรับการทำซ้ำ (คำขอ) แต่ละครั้ง
• random_number_milliseconds คือจำนวนมิลลิวินาทีแบบสุ่มที่น้อยกว่าหรือเท่ากับ 1,000 ซึ่งจะช่วยหลีกเลี่ยงกรณีที่ไคลเอ็นต์จำนวนมากซิงค์ข้อมูลตามสถานการณ์บางอย่างและลองใหม่ทั้งหมดพร้อมกัน โดยส่งคำขอเป็นคลื่นที่ซิงค์ข้อมูล ระบบจะคำนวณค่าของ random_number_milliseconds ใหม่หลังจากคำขอให้ลองอีกครั้งแต่ละรายการ
• maximum_backoff มักจะมีความยาว 32 หรือ 64 วินาที ค่าที่เหมาะสมจะขึ้นอยู่กับกรณีการใช้งาน

ไคลเอ็นต์จะลองใหม่ได้หลังจากผ่านไป maximum_backoff ครั้ง การลองใหม่หลังจากจุดนี้ไม่จำเป็นต้องเพิ่มเวลา Backoff ต่อไป ตัวอย่างเช่น หากไคลเอ็นต์ใช้เวลา maximum_backoff 64 วินาที หลังจากถึงค่านี้แล้ว ไคลเอ็นต์จะลองใหม่ได้ทุกๆ 64 วินาที เมื่อถึงจุดหนึ่ง คุณควรป้องกันไม่ให้ไคลเอ็นต์ลองใหม่ไปเรื่อยๆ อย่างไม่มีที่สิ้นสุด

เวลารอระหว่างการลองใหม่และจำนวนครั้งที่ลองใหม่จะขึ้นอยู่กับ Use Case และสภาพเครือข่ายของคุณ

ราคา

การใช้งาน Google Drive API แบบมาตรฐานทั้งหมดจะไม่มีค่าใช้จ่ายเพิ่มเติม เราวางแผนที่จะเรียกเก็บเงินจากบัญชีสำหรับการเรียกเก็บเงินใน Google Cloud ของคุณในภายหลังในปี 2026 หากคำขอเกินขีดจำกัดโควต้า โปรดดูข้อมูลเพิ่มเติมที่หัวข้อโมเดลมาตรฐานของ Google Workspace สำหรับเครื่องมือและ API ของ Agent

ขอเพิ่มโควต้า

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

โปรเจ็กต์ทั้งหมดไม่ได้มีโควต้าเท่ากัน เมื่อคุณใช้ Google Cloud มากขึ้นเรื่อยๆ คุณอาจต้องเพิ่มค่าโควต้า หากคาดว่าการใช้งานจะเพิ่มขึ้นอย่างมากในอนาคต คุณสามารถขอปรับโควต้าล่วงหน้าได้จากหน้าโควต้าและขีดจำกัดของระบบในคอนโซล Google Cloud

ดูข้อมูลเพิ่มเติมได้ที่แหล่งข้อมูลต่อไปนี้

• เกี่ยวกับการปรับโควต้า
• ดูการใช้งานและขีดจำกัดโควต้า
• การขอเพิ่มขีดจำกัดโควต้า

โควต้าเซิร์ฟเวอร์ MCP ของไดรฟ์

เซิร์ฟเวอร์ MCP ของไดรฟ์ใช้เมตริกการจัดสรรต้นทุนการค้นหา ตารางต่อไปนี้แสดงรายละเอียดค่าใช้จ่ายในการค้นหาสำหรับเมธอดเซิร์ฟเวอร์ MCP ของไดรฟ์แต่ละเมธอดตามส่วนต่างๆ

โควต้า MCP ของไดรฟ์

ระบบจะบังคับใช้โควต้า 2 ประเภท ได้แก่

• ต่อนาทีต่อโปรเจ็กต์: ค่าใช้จ่ายในการค้นหาสำหรับโปรเจ็กต์ Google Cloud เป็นเวลา 1 นาที

• ต่อนาทีต่อผู้ใช้ต่อโปรเจ็กต์: นี่คือค่าใช้จ่ายในการค้นหาสำหรับโปรเจ็กต์ Google Cloud เป็นเวลา 1 นาทีที่ผู้ใช้รายใดรายหนึ่งสามารถใช้ได้

ตารางต่อไปนี้แสดงรายละเอียดโควต้าเหล่านี้

ประเภทขีดจำกัดการใช้งาน	ขีดจำกัด
ต่อนาทีต่อโปรเจ็กต์	325,000
ต่อนาทีต่อผู้ใช้ต่อโปรเจ็กต์	1,000,000

โควต้าชุดเครื่องมือ MCP ของไดรฟ์

ตารางต่อไปนี้แสดงรายละเอียดค่าใช้จ่ายในการค้นหาสำหรับชุดเครื่องมือ drivemcp.googleapis.com แต่ละชุด

ปลายทาง	เครื่องมือ	ค่าใช้จ่ายในการค้นหา
/mcp/v1	copy_file	50
	create_file	50
	download_file_content	200
	get_file_metadata	5
	get_file_permissions	5
	list_recent_files	100
	read_file_content	200
	search_files	100

ดูข้อมูลเพิ่มเติมได้ที่เอกสารอ้างอิง API ของ MCP ในไดรฟ์

หัวข้อที่เกี่ยวข้อง

• ปรับปรุงประสิทธิภาพ
• ขีดจำกัดของไฟล์และโฟลเดอร์
• ขีดจำกัดของไฟล์และโฟลเดอร์ในไดรฟ์ที่แชร์