ขีดจำกัดและโควต้าการใช้งาน

ขีดจำกัดและโควต้าช่วยปกป้องโครงสร้างพื้นฐานของ Google จากกระบวนการอัตโนมัติ ที่ใช้ Admin Settings API ในทางที่ไม่เหมาะสม คำขอที่มากเกินไปจาก API อาจเกิดจากการพิมพ์ผิดที่ไม่มีอันตราย หรืออาจเกิดจากระบบที่ออกแบบมาอย่างไม่มีประสิทธิภาพซึ่งทำให้มีการเรียก API โดยไม่จำเป็น ไม่ว่าสาเหตุคืออะไร การบล็อกการเข้าชมจากแหล่งที่มาที่เฉพาะเจาะจงเมื่อถึงระดับหนึ่งเป็นสิ่งจำเป็นต่อสุขภาพโดยรวมของระบบ Google Workspace ซึ่งช่วยให้มั่นใจได้ว่าการกระทำของนักพัฒนาแอปรายหนึ่งจะไม่ส่งผลเสียต่อชุมชนในวงกว้าง

ในกรณีที่คำขอ API ไม่สำเร็จ คุณจะได้รับการตอบกลับเป็นรหัสสถานะ HTTP รหัสสถานะ 403 มีข้อมูลข้อผิดพลาดเกี่ยวกับการป้อนข้อมูลที่ไม่ถูกต้อง และรหัสสถานะ HTTP 503 มีข้อมูลข้อผิดพลาดที่ระบุโควต้า API ที่เกิน การตอบกลับเหล่านี้ช่วยให้แอปพลิเคชันที่กำหนดเองตรวจพบ ข้อผิดพลาดเหล่านี้และดำเนินการอย่างเหมาะสม

หากคำขอของคุณต้องดำเนินการให้เสร็จภายในระยะเวลาที่กำหนด ให้ส่งคำขอแบบขนานหรือใช้หลายเทรดในแอปพลิเคชัน Java หรือ C# เช่น แบ่งคำขอตามเดือนหรือช่วงเวลาอื่น ในกรณีของ เธรด ให้ลองเริ่มต้นด้วย 10 เธรด โดยมี 1 เธรดต่อคำขอ โปรดทราบว่าคำแนะนำเกี่ยวกับเธรดมีข้อดีข้อเสียและไม่เหมาะกับสถานการณ์ API ทั้งหมด หาก จำนวนคำขอสูงเกินไป จะเกิดข้อผิดพลาดเกี่ยวกับโควต้า

สำหรับข้อผิดพลาดทั้งหมดที่อิงตามเวลา (สูงสุด N รายการเป็นเวลา X วินาทีต่อ เธรด) โดยเฉพาะข้อผิดพลาดรหัสสถานะ 503 เราขอแนะนำให้โค้ดของคุณตรวจหา ข้อยกเว้น และใช้อัลกอริทึม Exponential Backoff เพื่อรอการหน่วงเวลาเล็กน้อยก่อนที่จะลองเรียกใช้ที่ล้มเหลวอีกครั้ง ตัวอย่าง 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

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