บริการของ Google Apps Script มีโควต้าและข้อจำกัดรายวันสำหรับฟีเจอร์บางอย่าง หากคุณเกินโควต้าหรือข้อจำกัด สคริปต์จะส่งข้อยกเว้น และหยุดการดำเนินการ
ฟีเจอร์บางอย่างมีโควต้าเพิ่มเติมจากผลิตภัณฑ์ Google ที่เชื่อมโยง การใช้บริการ Apps Script ของผลิตภัณฑ์จะนับรวมในโควต้าสำรองที่เกี่ยวข้องทั้งหมด ฟีเจอร์จะใช้งานไม่ได้หากคุณถึงโควต้าที่เกี่ยวข้อง
โควต้าปัจจุบัน
โควต้าจะตั้งค่าในระดับต่างๆ สำหรับผู้ใช้บัญชีทั่วไป (เช่น @gmail.com) และบัญชี Google Workspace โควต้าเป็นต่อผู้ใช้และจะรีเซ็ต 24 ชั่วโมงหลังจากคำขอแรก
ใช้โควต้าต่อไปนี้เพื่อช่วยทดสอบสคริปต์ โควต้าทั้งหมดอาจมีการยกเลิก ลด หรือเปลี่ยนแปลงได้ทุกเมื่อโดยไม่ต้องแจ้งให้ทราบ
| ฟีเจอร์ | บัญชีผู้ใช้ทั่วไป (เช่น gmail.com) | บัญชี Google Workspace |
|---|---|---|
| กิจกรรมที่สร้างในปฏิทิน | 5,000 / วัน | 10,000 / วัน |
| รายชื่อติดต่อที่สร้าง | 1,000 / วัน | 2,000 / วัน |
| เอกสารที่สร้าง | 250 / วัน | 1,500 / วัน |
| ไฟล์ที่แปลงแล้ว | 2,000 / วัน | 4,000 / วัน |
| ผู้รับอีเมลต่อวัน (เช่น ด้วย MailApp) | 100* / วัน | 1,500* / วัน |
| ผู้รับอีเมลต่อวันภายในโดเมน (เช่น ด้วย MailApp) | 100* / วัน | 2,000 / วัน |
| การอ่าน/เขียนอีเมล (ไม่รวมการส่ง) | 20,000 / วัน | 50,000 / วัน |
| การอ่าน Groups | 2,000 / วัน | 10,000 / วัน |
| การเชื่อมต่อ JDBC | 10,000 / วัน | 50,000 / วัน |
| การเชื่อมต่อ JDBC ล้มเหลว | 100 / วัน | 500 / วัน |
| สร้างงานนำเสนอแล้ว | 250 / วัน | 1,500 / วัน |
| คุณสมบัติอ่าน/เขียน | 50,000 / วัน | 500,000 / วัน |
| สร้างสไลด์แล้ว | 250 / วัน | 1,500 / วัน |
| สเปรดชีตที่สร้าง | 250 / วัน | 3,200 / วัน |
| รันไทม์รวมสำหรับการทริกเกอร์ | 90 นาที / วัน | 6 ชม./วัน |
| การเรียก URL | 20,000 / วัน | 100,000 / วัน |
| การแสดงผลแผนที่แบบคงที่ | 1,000 / วัน | 10,000 / วัน |
| คำค้นหาเส้นทางใน Google Maps | 1,000 / วัน | 10,000 / วัน |
| การเรียกใช้การเข้ารหัสพิกัดภูมิศาสตร์ของ Google Maps | 1,000 / วัน | 10,000 / วัน |
| แปลการโทร | 5,000 / วัน | 20,000 / วัน |
| คำค้นหาตัวอย่างระดับความสูงของ Google Maps | 1,000 / วัน | 10,000 / วัน |
| โปรเจ็กต์ Apps Script | 50 / วัน | 50 / วัน |
บัญชีทดลองใช้จะมีขีดจำกัดเพิ่มเติม หลังจากที่แปลงบัญชีทดลองใช้ฟรีเป็นการสมัครใช้บริการแบบชำระเงิน ขีดจำกัดของบัญชีคุณจะเพิ่มขึ้นโดยอัตโนมัติเมื่อเงื่อนไขทั้งสองประการนี้เป็นจริง
- โดเมนมียอดชำระเงินสะสมอย่างน้อย USD $100 (หรือเทียบเท่า)
- เมื่อเวลาผ่านไปอย่างน้อย 60 วันนับตั้งแต่ใช้งานถึงเกณฑ์การชำระเงินดังกล่าว
ข้อจำกัดในปัจจุบัน
ใช้ขีดจำกัดต่อไปนี้เพื่อช่วยทดสอบสคริปต์ ขีดจำกัดทั้งหมดอาจมีการยกเลิก ลด หรือเปลี่ยนแปลงได้ทุกเมื่อโดยไม่ต้องแจ้งให้ทราบ
| ฟีเจอร์ | บัญชีผู้ใช้ทั่วไป (เช่น gmail.com) | บัญชี Google Workspace |
|---|---|---|
| รันไทม์ของสคริปต์ | 6 นาที / การดำเนินการ | 6 นาที / การดำเนินการ |
| รันไทม์ของฟังก์ชันที่กำหนดเอง | 30 วินาที / การดำเนินการ | 30 วินาที / การดำเนินการ |
| รันไทม์ของส่วนเสริม Google Workspace | 30 วินาที / การดำเนินการ | 30 วินาที* / การดำเนินการ |
| การดำเนินการพร้อมกันต่อผู้ใช้ | 30 / ผู้ใช้ | 30 / ผู้ใช้ |
| การดำเนินการพร้อมกันต่อสคริปต์ | 1,000 | 1,000 |
| ไฟล์แนบของอีเมล | 250 / ข้อความ | 250 / ข้อความ |
| ขนาดเนื้อหาของอีเมล | 200 KB / ข้อความ | 400 KB / ข้อความ |
| ผู้รับอีเมลต่อข้อความ | 50 / ข้อความ | 50 / ข้อความ |
| ขนาดไฟล์แนบทั้งหมดของอีเมล | 25 MB / ข้อความ | 25 MB / ข้อความ |
| ขนาดค่าพร็อพเพอร์ตี้ | 9 KB / val | 9 KB / val |
| พื้นที่เก็บข้อมูลทั้งหมดของพร็อพเพอร์ตี้ | 500 KB / ร้านค้าของพร็อพเพอร์ตี้ | 500 KB / ร้านค้าของพร็อพเพอร์ตี้ |
| ทริกเกอร์ | 20 / ผู้ใช้ / สคริปต์ | 20 / ผู้ใช้ / สคริปต์ |
| ขนาดการตอบกลับของ URL Fetch | 50 MB / การเรียกใช้ | 50 MB / การเรียกใช้ |
| ส่วนหัวของ URL Fetch | 100 / การเรียกใช้ | 100 / การเรียกใช้ |
| ขนาดส่วนหัวของ URL Fetch | 8 KB / การเรียกใช้ | 8 KB / การเรียกใช้ |
| ขนาด POST ของการดึงข้อมูล URL | 50 MB / การเรียกใช้ | 50 MB / การเรียกใช้ |
| ความยาว URL ของ URL Fetch | 2 KB / การเรียกใช้ | 2 KB / การเรียกใช้ |
| เวอร์ชัน | 200 / สคริปต์ | 200 / สคริปต์ |
ตรวจสอบการใช้งานโควต้า
หากต้องการตรวจสอบการใช้โควต้าและสถานะการดำเนินการของสคริปต์ ให้ใช้วิธีการต่อไปนี้
- โควต้าอีเมล: ใช้
MailApp.getRemainingDailyQuota()เพื่อตรวจสอบจำนวนผู้รับอีเมลที่เหลือซึ่งคุณส่งได้ใน ช่วงเวลาที่เหลือของวัน - การตรวจสอบการดำเนินการ: ใช้แดชบอร์ด Apps Script เพื่อดูประวัติการดำเนินการและสถานะของสคริปต์ หน้าการดำเนินการของฉันจะแสดงสถานะ (เช่น
Completed,FailedหรือRunning) ของการดำเนินการสคริปต์แต่ละรายการ คุณตรวจสอบจำนวนการดำเนินการพร้อมกันได้โดย กรองการดำเนินการที่มีสถานะเป็นRunning - Google Cloud Console: หากโปรเจ็กต์ Apps Script ใช้โปรเจ็กต์ Google Cloud มาตรฐาน คุณจะตรวจสอบโควต้าเฉพาะบริการและการใช้งาน API ได้ใน Google Cloud Console
ข้อความแสดงข้อยกเว้น
หากสคริปต์ถึงโควต้าหรือข้อจำกัด ระบบจะแสดงข้อยกเว้นพร้อมข้อความที่คล้ายกับข้อความต่อไปนี้
Limit exceeded: Email Attachments Per Message.ซึ่งหมายความว่าสคริปต์ เกินโควต้าหรือข้อจำกัดอย่างใดอย่างหนึ่งที่ระบุไว้ในส่วน โควต้าปัจจุบันหรือ ข้อจำกัดปัจจุบันService invoked too many times: Calendar.ข้อความนี้บ่งชี้ว่าสคริปต์เรียกใช้บริการที่ระบุหลายครั้งเกินไปใน 1 วันService invoked too many times in a short time: Calendar. Try Utilities.sleep(1000) between calls.ซึ่งบ่งบอกว่าสคริปต์ เรียกใช้บริการที่ระบุหลายครั้งเกินไปในระยะเวลาอันสั้นService using too much computer time for one day.ซึ่งหมายความว่าสคริปต์ใช้เวลาในการดำเนินการเกินเวลาที่อนุญาตทั้งหมดสำหรับ 1 วัน โดยส่วนใหญ่แล้วข้อผิดพลาดนี้จะเกิดขึ้นกับสคริปต์ที่ทำงานในทริกเกอร์ ซึ่งมีขีดจำกัดรายวันต่ำกว่าสคริปต์ที่ดำเนินการด้วยตนเองScript invoked too many times per second for this Google user account.ซึ่งบ่งบอกว่าสคริปต์เริ่มดำเนินการหลายครั้งเกินไปในระยะเวลาสั้นๆ โดยมักเกิดขึ้นกับฟังก์ชันที่กำหนดเองซึ่งมีการเรียกใช้ซ้ำๆ ในสเปรดชีตเดียว หากต้องการหลีกเลี่ยงข้อผิดพลาดนี้ ให้เขียนโค้ดฟังก์ชันที่กำหนดเองเพื่อให้เรียกใช้ได้เพียงครั้งเดียวต่อช่วงข้อมูล ตามที่อธิบายไว้ในคำแนะนำเกี่ยวกับฟังก์ชันที่กำหนดเองThere are too many scripts running simultaneously for this Google user account.ซึ่งหมายความว่าคุณมีสคริปต์ที่ดำเนินการพร้อมกันมากเกินไป แม้ว่าอาจจะไม่ใช่สคริปต์เดียวกันก็ตาม เช่นเดียวกับข้อยกเว้นก่อนหน้า กรณีนี้ มักเกิดขึ้นกับฟังก์ชันที่กำหนดเองซึ่งเรียกใช้ซ้ำๆ ใน สเปรดชีตเดียว