ขีดจํากัดและโควต้าช่วยปกป้องโครงสร้างพื้นฐานของ Google จากกระบวนการอัตโนมัติ ที่ใช้ Admin Settings API ในทางที่ไม่เหมาะสม คำขอที่มากเกินไปจาก API อาจเกิดจากการพิมพ์ผิดที่ไม่มีอันตราย หรืออาจเกิดจากระบบที่ออกแบบมาอย่างไม่มีประสิทธิภาพซึ่งทำให้มีการเรียก API โดยไม่จำเป็น ไม่ว่าสาเหตุจะเป็นอะไร การบล็อกการเข้าชมจากแหล่งที่มาที่เฉพาะเจาะจงเมื่อถึงระดับหนึ่งเป็นสิ่งจำเป็นต่อสุขภาพโดยรวมของระบบ Google Workspace ซึ่งช่วยให้มั่นใจได้ว่าการกระทำของนักพัฒนาแอปรายหนึ่งจะไม่ส่งผลเสียต่อชุมชนในวงกว้าง
ในกรณีที่คำขอ API ไม่สำเร็จ คุณจะได้รับการตอบกลับเป็นรหัสสถานะ HTTP รหัสสถานะ 403 มีข้อมูลข้อผิดพลาดเกี่ยวกับการป้อนข้อมูลที่ไม่ถูกต้อง และรหัสสถานะ HTTP 503 มีข้อมูลข้อผิดพลาดที่ระบุโควต้า API ที่เกิน การตอบกลับเหล่านี้ช่วยให้แอปพลิเคชันที่กำหนดเองตรวจหา ข้อผิดพลาดเหล่านี้และดำเนินการที่เหมาะสมได้
หากคำขอของคุณต้องดำเนินการให้เสร็จภายในระยะเวลาที่กำหนด ให้ส่งคำขอแบบขนานหรือใช้หลายเธรดในแอปพลิเคชัน Java หรือ C# เช่น แบ่งคำขอตามเดือนหรือช่วงเวลาอื่น ในกรณีของ เธรด ให้ลองเริ่มต้นด้วย 10 เธรด โดยมี 1 เธรดต่อคำขอ โปรดทราบว่าคำแนะนำเกี่ยวกับเธรด มีข้อดีข้อเสียและไม่เหมาะกับสถานการณ์ API ทั้งหมด หาก จำนวนคำขอสูงเกินไป จะเกิดข้อผิดพลาดเกี่ยวกับโควต้า
สำหรับข้อผิดพลาดทั้งหมดที่อิงตามเวลา (สูงสุด N รายการเป็นเวลา X วินาทีต่อ เธรด) โดยเฉพาะข้อผิดพลาดรหัสสถานะ 503 เราขอแนะนำให้โค้ดของคุณตรวจจับ ข้อยกเว้น และใช้อัลกอริทึมการถอยแบบทวีคูณ เพื่อรอการหน่วงเวลาเล็กน้อยก่อนที่จะลองเรียกใช้ที่ล้มเหลวอีกครั้ง ตัวอย่าง Email Settings API สำหรับ 1 เธรดคือการรอ 5 วินาทีแล้วลองเรียกใช้ที่ล้มเหลว อีกครั้ง หากคำขอสำเร็จ ให้ทำตามรูปแบบนี้กับเธรดอื่นๆ หากคำขอครั้งที่ 2 ไม่สำเร็จ แอปพลิเคชันควรลดความถี่ของคำขอลงจนกว่าการเรียกจะสำเร็จ เช่น เพิ่ม การหน่วงเวลาเริ่มต้น 5 วินาทีเป็น 10 วินาที แล้วลองโทรอีกครั้ง นอกจากนี้ ให้ กำหนดขีดจำกัดการลองใหม่ เช่น ลองส่งคำขออีกครั้ง 5-7 ครั้งโดยมี ระยะเวลารอที่แตกต่างกันก่อนที่แอปพลิเคชันจะแสดงข้อผิดพลาดแก่ผู้ใช้
| หมวดหมู่โควต้า API | โควต้า |
|---|---|
| โทเค็นการตรวจสอบสิทธิ์ ClientLogin | ใช้ได้ 24 ชั่วโมง ข้อผิดพลาดคือ "โทเค็น 401 หมดอายุ" |
| การสร้างคีย์สาธารณะและส่วนตัว |
สร้างชุดคีย์สาธารณะและส่วนตัวโดยใช้ อัลกอริทึม DSA หรือ RSA กับผู้ให้บริการข้อมูลประจำตัว คีย์สาธารณะอยู่ในใบรับรองรูปแบบ X.509 ดูข้อมูลเพิ่มเติมเกี่ยวกับคีย์การลงนามแบบลงชื่อเพียงครั้งเดียวที่ใช้ SAML ได้ที่หัวข้อการสร้างคีย์และใบรับรองสำหรับบริการลงชื่อเพียงครั้งเดียวของ Google Workspace |
| โลโก้ |
ไฟล์รูปภาพโลโก้ของบัญชีต้องอยู่ในรูปแบบ JPEG, PNG หรือ GIF ขนาดที่แนะนำคือ 143 x 59 พิกเซล และไฟล์ควรมีขนาดเล็กกว่า 20 KB เมื่อใช้โลโก้ที่กำหนดเอง โปรดอย่าลืมปฏิบัติตามข้อกำหนด ในการให้บริการของ Google และอย่าใช้โลโก้ของ Google, โลโก้ของ Gmail หรือโลโก้อื่นๆ ของ Google ดูข้อมูลเพิ่มเติมได้ที่ นโยบายโลโก้และหน้า Landing Page |
| ssoWhitelist |
ssoWhitelist คือที่อยู่ IP ของเน็ตเวิร์กมาสก์ในรูปแบบ Classless Inter-Domain Routing (CIDR) |
| ขีดจำกัดประเภทอื่นๆ | ข้อจำกัดและหลักเกณฑ์ |
|---|---|
| สถานะการยืนยันระเบียน MX |
สถานะการยืนยันระเบียน MX เริ่มต้นคือ `false` ซึ่งหมายความว่า ระบบของ Google ไม่ได้ตรวจสอบการกำหนดค่าระเบียน MX ของคุณเมื่อเร็วๆ นี้ หรือไม่ได้กำหนดค่าระเบียน MX ให้ชี้ไปยังระบบของ Google หากคุณอัปเดตระเบียนแล้วและสถานะการยืนยัน ยังคงเป็นเท็จ แสดงว่าการอัปเดตระเบียน MX ยังไม่ได้ เผยแพร่ หรือระเบียนมีข้อผิดพลาด สำหรับการเผยแพร่ เราขอแนะนำให้คุณรอตามระยะเวลาที่กำหนดโดยค่า Time To Live (TTL) ของระเบียน MX แล้วลองอีกครั้ง |
| รหัสประเทศ |
หากไม่ได้ปรับแต่งชื่อองค์กร ค่าเริ่มต้นจะเป็น ชื่อโดเมนหลัก ดูข้อมูลเกี่ยวกับอักขระชื่อองค์กรได้ที่การใช้อักขระ |
creationTime พร็อพเพอร์ตี้ การแสดงวันที่และเวลาเป็นตัวเลข |
ดู ISO 8601, การแสดงวันที่และเวลาด้วยตัวเลข |
| แท็กการเข้ารหัสภาษา |
ดูแท็กภาษา RFC 3066ที่ Google Mail ยอมรับ |
| ชื่อองค์กร |
หากไม่ได้ปรับแต่งชื่อองค์กร ค่าเริ่มต้นจะเป็น ชื่อโดเมนหลัก ดูข้อมูลเกี่ยวกับอักขระชื่อองค์กรได้ที่การใช้อักขระ |
ขอเพิ่มโควต้าต่อโปรเจ็กต์
คุณอาจต้องขอปรับโควต้า ทั้งนี้ขึ้นอยู่กับการใช้ทรัพยากรของโปรเจ็กต์ ระบบจะถือว่าการเรียก API โดยบัญชีบริการเป็นการใช้บัญชีเดียว การขอโควต้าที่ปรับแล้วอาจไม่ได้รับการอนุมัติเสมอไป คำขอปรับโควต้า ซึ่งจะเพิ่มค่าโควต้าอย่างมากอาจใช้เวลานานกว่าจะได้รับการอนุมัติ
โปรเจ็กต์แต่ละโปรเจ็กต์อาจมีโควต้าไม่เท่ากัน เมื่อคุณใช้ Google Cloud มากขึ้นเรื่อยๆ ค่าโควต้าอาจต้องเพิ่มขึ้น หากคาดการณ์ว่าการใช้งานจะเพิ่มขึ้นอย่างเห็นได้ชัดในอนาคต คุณสามารถขอปรับโควต้าล่วงหน้าได้จากหน้าโควต้าใน Google Cloud Console
ดูข้อมูลเพิ่มเติมได้ที่แหล่งข้อมูลต่อไปนี้