ขีดจํากัดและโควต้าช่วยปกป้องโครงสร้างพื้นฐานของ Google จากกระบวนการอัตโนมัติที่ใช้ Directory API ในลักษณะที่ไม่เหมาะสม คำขอจาก API ที่มากเกินไปอาจเกิดจากการพิมพ์ผิดที่ไม่ก่อให้เกิดอันตราย หรืออาจเกิดจากระบบที่ออกแบบมาอย่างไม่มีประสิทธิภาพซึ่งทําให้การเรียก API โดยไม่จําเป็น ไม่ว่าสาเหตุจะมาจากอะไร การบล็อกการเข้าชมจากแหล่งที่มาหนึ่งๆ เมื่อถึงระดับหนึ่งๆ เป็นสิ่งจําเป็นต่อประสิทธิภาพโดยรวมของระบบ Google Workspace ซึ่งช่วยให้มั่นใจได้ว่าการกระทำของนักพัฒนาแอปรายหนึ่งจะไม่ส่งผลเสียต่อชุมชนในวงกว้าง
ในกรณีที่คำขอ API ไม่สำเร็จ (ซึ่งเกิดขึ้นไม่บ่อย) API จะแสดงรหัสสถานะ HTTP และเหตุผลของข้อผิดพลาด นอกจากนี้ เนื้อหาของการตอบกลับยังมีคำอธิบายโดยละเอียดเกี่ยวกับสาเหตุที่ทำให้เกิดข้อผิดพลาด
รายการต่อไปนี้แสดงรหัสข้อผิดพลาดที่เป็นไปได้ สาเหตุ คำอธิบายที่เกี่ยวข้อง และการดำเนินการที่แนะนำสำหรับข้อผิดพลาดที่เกิดจากขีดจำกัดโควต้า
| รหัส | เหตุผล | คำอธิบาย | การดำเนินการที่แนะนำ |
|---|---|---|---|
| 403 | userRateLimitExceeded | บ่งบอกว่ามีผู้ใช้เกินขีดจํากัดอัตราแล้ว ค่าเริ่มต้นที่ตั้งไว้ในคอนโซล Google Cloud คือ 2,400 การค้นหาต่อนาทีต่อผู้ใช้ต่อโปรเจ็กต์ Google Cloud | เพิ่มขีดจํากัดต่อผู้ใช้จากหน้าโควต้า Admin SDK API ของโปรเจ็กต์ Google Cloud หรือลดอัตราการส่งคําขอโดยใช้การลดอัตราการส่งคำขอแบบทวีคูณ |
| 403 | quotaExceeded | บ่งบอกว่าคำขอการดำเนินการบางอย่างถึงขีดจำกัดแล้ว | ลองอีกครั้งโดยใช้ Exponential Backoff คุณต้องลดอัตราการส่งคำขอ |
| 429 | rateLimitExceeded | บ่งบอกว่าคำขอการดำเนินการบางอย่างถึงขีดจำกัดแล้ว | ลองอีกครั้งโดยใช้ Exponential Backoff คุณต้องลดอัตราการส่งคำขอ ขีดจํากัดนี้คิดต่อบัญชี Google Workspace ไม่ใช่ต่อไคลเอ็นต์ API หรือต่อผู้ใช้ ไม่สามารถเพิ่มขีดจำกัดนี้ |
การใช้ Exponential Backoff
Exponential Backoffคือการที่ไคลเอ็นต์ส่งคำขอที่ล้มเหลวอีกครั้งเป็นระยะๆ โดยใช้เวลานานขึ้นเรื่อยๆ ซึ่งเป็นกลยุทธ์การจัดการข้อผิดพลาดมาตรฐานสําหรับแอปพลิเคชันเครือข่าย การใช้ Exponential Backoff จะเพิ่มประสิทธิภาพในการใช้แบนด์วิดท์ ลดจำนวนคำขอที่จําเป็นต่อการตอบกลับที่ประสบความสําเร็จ และเพิ่มปริมาณงานของคําขอในสภาพแวดล้อมแบบพร้อมกันให้สูงสุด
ขั้นตอนในการใช้ Exponential Backoff แบบง่ายมีดังนี้
- ส่งคําขอไปยัง API
- ได้รับการตอบกลับที่มีข้อผิดพลาดซึ่งมีรหัสข้อผิดพลาดที่ลองใหม่ได้
- รอ 1 วินาที +
random_number_millisecondsวินาที - ลองส่งคำขออีกครั้ง
- ได้รับการตอบกลับที่มีข้อผิดพลาดซึ่งมีรหัสข้อผิดพลาดที่ลองใหม่ได้
- รอ 2 วินาที +
random_number_millisecondsวินาที - ลองส่งคำขออีกครั้ง
- ได้รับการตอบกลับที่มีข้อผิดพลาดซึ่งมีรหัสข้อผิดพลาดที่ลองใหม่ได้
- รอ 4 วินาที +
random_number_millisecondsวินาที - ลองส่งคำขออีกครั้ง
- ได้รับการตอบกลับที่มีข้อผิดพลาดซึ่งมีรหัสข้อผิดพลาดที่ลองใหม่ได้
- รอ 8 วินาที +
random_number_millisecondsวินาที - ลองส่งคำขออีกครั้ง
- ได้รับการตอบกลับที่มีข้อผิดพลาดซึ่งมีรหัสข้อผิดพลาดที่ลองใหม่ได้
- รอ 16 วินาที +
random_number_millisecondsวินาที - ลองส่งคำขออีกครั้ง
- หากยังพบข้อผิดพลาดอยู่ ให้หยุดและบันทึกข้อผิดพลาด
ในขั้นตอนข้างต้น random_number_milliseconds คือจำนวนมิลลิวินาทีแบบสุ่มที่น้อยกว่าหรือเท่ากับ 1, 000 ซึ่งจําเป็นต่อการหลีกเลี่ยงข้อผิดพลาดบางอย่างเกี่ยวกับการล็อกในการใช้งานพร้อมกัน
random_number_milliseconds ต้องได้รับการกําหนดใหม่หลังจากการรอแต่ละครั้ง
หมายเหตุ: เวลาที่รอจะเท่ากับ (2 ^ n) + random_number_milliseconds เสมอ โดยที่ n คือจำนวนเต็มที่เพิ่มขึ้นอย่างเดียวซึ่งกำหนดไว้ตั้งแต่ต้นเป็น 0 โดย n จะเพิ่มขึ้น 1 สำหรับแต่ละรอบ (คำขอแต่ละรายการ)
อัลกอริทึมได้รับการตั้งค่าให้สิ้นสุดเมื่อ n เป็น 5 ขีดจํากัดนี้มีไว้เพื่อหยุดไม่ให้ไคลเอ็นต์ลองใหม่อย่างไม่สิ้นสุดเท่านั้น และส่งผลให้เกิดความล่าช้าทั้งหมดประมาณ 32 วินาทีก่อนที่คําขอจะถือว่า "ข้อผิดพลาดที่แก้ไขไม่ได้" ไคลเอ็นต์ API ของคุณสามารถใช้จำนวนครั้งที่พยายามสูงกว่านี้ได้หากจำเป็น
ขีดจํากัดและโควต้าของ API
| หมวดหมู่ขีดจํากัด API | จำกัดสูงสุด |
|---|---|
| การสร้างผู้ใช้ | คุณสร้างผู้ใช้ได้ไม่เกิน 10 รายต่อโดเมนต่อวินาทีโดยใช้ Directory API |
| เพิ่มกลุ่มเป็นสมาชิกของกลุ่มอื่น | ระบบอาจใช้เวลาถึง 10 นาทีก่อนที่สมาชิกของกลุ่มย่อยจะปรากฏในฐานะสมาชิกของกลุ่มหลัก ซึ่งขีดจํากัดนี้อาจเปลี่ยนแปลงได้ตามความจุของระบบ |
| อุปกรณ์เคลื่อนที่ |
เมื่อใช้ Directory API คุณจะดำเนินการได้สูงสุดดังนี้
|
| การเปลี่ยนชื่อผู้ใช้ | อาจใช้เวลาถึง 10 นาทีจึงจะมีผลกับบริการทั้งหมด ก่อนเปลี่ยนชื่อผู้ใช้ เราขอแนะนำให้ออกจากระบบผู้ใช้จากเซสชันและบริการเบราว์เซอร์ทั้งหมด โปรดดูรายละเอียดเพิ่มเติมที่หัวข้ออัปเดตผู้ใช้ |
| การสร้าง/การอัปเดตหน่วยขององค์กร |
|
| หมวดหมู่โควต้า API | โควต้า |
อุปกรณ์ Chrome annotatedLocation เครื่อง อักขระสูงสุด
|
จำนวนอักขระสูงสุดสำหรับข้อมูลตำแหน่งของอุปกรณ์คือ 200 ตัว |
อุปกรณ์ Chrome notes เครื่อง อักขระสูงสุด
|
จำนวนอักขระสูงสุดสำหรับข้อมูลหมายเหตุของอุปกรณ์คือ 500 ตัว |
อุปกรณ์ Chrome, อักขระได้สูงสุด user ตัว
|
จำนวนอักขระสูงสุดสำหรับชื่อผู้ใช้อุปกรณ์คือ 100 ตัว |
| ชื่อแทนโดเมนสูงสุด | จำนวนโดเมนแทนสูงสุดคือ 20 รายการ |
| กลุ่ม คําอธิบาย | คำอธิบายมีอักขระได้สูงสุด 4,096 ตัว |
| กลุ่มต่อบัญชี | บัญชี G Suite รุ่นเดิมที่ใช้งานฟรีจะมีกลุ่มได้สูงสุด 10 กลุ่ม ส่วนรุ่นอื่นๆ จะไม่มีขีดจำกัดจำนวนกลุ่ม |
| กลุ่ม สมาชิกต่อกลุ่ม | เมื่อใช้บัญชี G Suite รุ่นเดิมที่ใช้งานฟรี กลุ่มจะมีสมาชิกได้สูงสุด 100 คน ส่วนรุ่นอื่นๆ จะไม่มีขีดจำกัดจำนวนสมาชิกของกลุ่ม ดูขีดจำกัดการเป็นสมาชิกกลุ่มต่อผู้ใช้ได้ที่หัวข้อทำความเข้าใจนโยบายและขีดจำกัดของ Groups |
| สตริงการค้นหา maxResults | API จะแสดงผลดังนี้
|
| โดเมนหลายรายการ จำนวนโดเมนสูงสุดที่อนุญาตในบัญชี | 600 (โดเมนหลัก 1 รายการ + โดเมนเพิ่มเติม 599 รายการ) |
| หน่วยขององค์กร จำนวนผู้ใช้สูงสุดที่ย้ายพร้อมกันได้ | ย้ายผู้ใช้ได้ครั้งละ 20 คน และอีเมลหลักของผู้ใช้ต้องอยู่ในบัญชีอยู่แล้ว |
| ชื่อแทนของผู้ใช้ | จำนวนอีเมลแทนทั้งหมดที่อนุญาตสำหรับบัญชีผู้ใช้ทุกบัญชีคือ 30 รายการ |
| ชื่อแทนของผู้ใช้ที่ใช้ชื่อแทนที่ลบไปแล้ว | คุณใช้ชื่อแทนของผู้ใช้ที่ถูกลบแล้วได้อีกครั้งทันที |
| ข้อจำกัดประเภทอื่นๆ | ข้อจำกัดและหลักเกณฑ์ |
|---|---|
| การเรียกเก็บเงินและการสร้างผู้ใช้ | สำหรับผู้ใช้แพ็กเกจแบบยืดหยุ่นของ Google Workspace การสร้างผู้ใช้โดยใช้ API นี้จะส่งผลต่อการเงินและจะส่งผลให้มีการเรียกเก็บเงินจากบัญชีการเรียกเก็บเงินของลูกค้า ตัวอย่างเช่น หากคุณใช้แพ็กเกจแบบยืดหยุ่นของ Google Workspace การสร้างผู้ใช้ 10 รายจะส่งผลให้มีการเรียกเก็บเงินค่าใบอนุญาต Google Workspace 10 รายการในบัญชีของคุณ โดยระบบจะคิดค่าบริการตามสัดส่วนจากเวลาที่สร้างเสร็จ หากใช้แพ็กเกจรายปี แสดงว่าคุณได้ตกลงที่จะชำระเงินสำหรับใบอนุญาตจำนวนหนึ่งล่วงหน้าแล้ว และคุณจะสร้างผู้ใช้ได้เท่ากับจำนวนที่คุณตกลงไว้เท่านั้น ดูข้อมูลเพิ่มเติมเกี่ยวกับแพ็กเกจการเรียกเก็บเงินและบัญชีการเรียกเก็บเงินได้ที่ศูนย์ช่วยเหลือด้านการดูแลระบบ |
| ชื่อและนามสกุล | ชื่อและนามสกุลมีความยาวได้สูงสุด 40 อักขระ โดยรองรับอักขระ Unicode/UTF-8 และอาจมีเว้นวรรค อักษร (a-z) ตัวเลข (0-9) เครื่องหมายขีดกลาง (-) เครื่องหมายทับ (/) และเครื่องหมายจุด (.) ดูข้อมูลเพิ่มเติมเกี่ยวกับกฎการใช้อักขระได้ที่ศูนย์ช่วยเหลือด้านการดูแลระบบ |
| การลบกลุ่ม | การลบกลุ่มจะไม่ลบบัญชีผู้ใช้ของสมาชิกกลุ่ม |
| กลุ่มและสมาชิกกลุ่ม การเปลี่ยนแปลงอีเมล | ใน API เวอร์ชันนี้ คุณจะเปลี่ยนอีเมลของกลุ่มได้ก่อนที่จะเปิดใช้บริการ Google Workspace ใช้คอนโซลผู้ดูแลระบบเพื่อเปลี่ยนอีเมลของสมาชิกกลุ่ม เมื่อเปลี่ยนแล้ว API จะแสดงการเปลี่ยนแปลงอีเมลโดยอัตโนมัติ |
| กลุ่ม การตั้งค่า | จัดการการตั้งค่าการเข้าถึงกลุ่ม ตัวเลือกการแชร์ การตรวจสอบ และที่เก็บการสนทนาโดยใช้คอนโซลผู้ดูแลระบบ ดูข้อมูลเพิ่มเติมเกี่ยวกับการตั้งค่ากลุ่มได้ที่ศูนย์ช่วยเหลือด้านการดูแลระบบ |
| กลุ่ม การส่งข้อความ | Google จำกัดจำนวนข้อความที่คุณส่งไปยังผู้รับภายนอกได้พร้อมกันเพื่อป้องกันสแปมและการละเมิดทางอีเมล หากคุณส่งข้อความไปยังกลุ่ม ระบบจะนับสมาชิกภายนอกแต่ละคนเป็นผู้รับ 1 ราย ดูข้อมูลเพิ่มเติมได้ที่ขีดจํากัดการส่งอีเมลและป้องกันไม่ให้ระบบบล็อกหรือนําอีเมลที่ส่งถึงผู้ใช้ Gmail ไปยังโฟลเดอร์จดหมายขยะ |
| กลุ่มที่ส่งข้อความ NDR | คุณไม่สามารถส่งหรือส่งต่อข้อความแจ้งการจัดส่งไม่ถึง (NDR) หรือที่เรียกว่า "ข้อความตีกลับ" ไปยังกลุ่มได้ |
| ข้อจํากัดของกลุ่มที่ผู้ใช้สร้างขึ้น | โปรดดูขีดจํากัดของกลุ่มที่ผู้ใช้สร้างขึ้นที่ศูนย์ช่วยเหลือด้านการดําเนินการ |
| หน่วยขององค์กร การเปิด/ปิดบริการ | ใช้คอนโซลผู้ดูแลระบบเพื่อจัดการการเปิดและปิดบริการสำหรับหน่วยขององค์กร |
| รหัสผ่าน | ประกอบด้วยอักขระผสมกันในรูปแบบใดก็ได้ ต้องมีอักขระอย่างน้อย 8 ตัว โดยมีความยาวสูงสุดได้ 100 อักขระ |
| Photos | ใน API เวอร์ชันนี้ รูปภาพคือรูปโปรไฟล์ Google ล่าสุดของผู้ใช้ |
| ชื่อผู้ใช้ | ชื่อผู้ใช้มีตัวอักษร (a-z) ตัวเลข (0-9) เครื่องหมายขีดกลาง (-) เครื่องหมายขีดล่าง (_) ได้ และ Google Workspace จะจดจำจุด (.) ซึ่งแตกต่างจาก Gmail ชื่อผู้ใช้ต้องไม่มีเครื่องหมายเท่ากับ (=), วงเล็บปีกกา (<,>) หรือมีจุด (.) มากกว่า 1 จุดต่อกัน ดูข้อมูลเพิ่มเติมได้ที่ศูนย์ช่วยเหลือด้านการดูแลระบบ |
| ชื่อผู้ใช้ การเปลี่ยนชื่อ | Google Hangouts จะทิ้งคำเชิญแชททั้งหมดที่จำไว้หลังจากเปลี่ยนชื่อ ผู้ใช้ต้องขอสิทธิ์เพื่อแชทกับเพื่อนอีกครั้ง ระบบจะเก็บชื่อผู้ใช้เดิมไว้เป็นอีเมลแทนเพื่อให้ส่งอีเมลได้อย่างต่อเนื่องในกรณีที่มีการตั้งค่าการส่งต่ออีเมล และชื่อผู้ใช้เดิมจะไม่สามารถใช้เป็นชื่อผู้ใช้ใหม่ได้ ดูรายละเอียดสำคัญเกี่ยวกับผลกระทบของการเปลี่ยนชื่อผู้ใช้ได้ที่ศูนย์ช่วยเหลือด้านการผู้ดูแลระบบ ใช้การดำเนินการลบอีเมลแทนของผู้ใช้เพื่อนำอีเมลแทนออกหลังจากเปลี่ยนชื่อ |
| ผู้ใช้ในหลายโดเมน | บัญชี Google Workspace สามารถรวมโดเมนใดก็ได้ ในบัญชีหลายโดเมน ผู้ใช้ในโดเมนหนึ่งจะแชร์บริการกับผู้ใช้ในโดเมนบัญชีอื่นๆ ได้ องค์ประกอบของหลายโดเมนมีดังนี้
|
| คำเตือน สมาชิกกลุ่ม | GROUP_CANNOT_CONTAIN_CYCLE – API ไม่อนุญาตให้มีรอบการเป็นสมาชิกกลุ่ม เช่น หาก group1 เป็นสมาชิกของ group2 แสดงว่า group2 จะเป็นสมาชิกของ group1 ไม่ได้ |