ขีดจำกัดและโควต้าช่วยปกป้องโครงสร้างพื้นฐานของ Google จากกระบวนการอัตโนมัติที่ใช้ Groups Settings API ในทางที่ไม่เหมาะสม คำขอที่มากเกินไปจาก API อาจเป็นผลมาจาก การพิมพ์ผิดที่ไม่เป็นอันตราย หรือระบบที่ได้รับการออกแบบมาอย่างไม่มีประสิทธิภาพซึ่งเรียกใช้ API ได้โดยไม่จำเป็น ไม่ว่าจะเกิดจากสาเหตุใด การบล็อกการเข้าชมจากแหล่งที่มาหนึ่งๆ เมื่อการเข้าชมถึงระดับหนึ่งๆ จะเป็น ที่จำเป็นต่อประสิทธิภาพโดยรวมของระบบ Google Workspace
ขอ API ไม่สำเร็จ
ในกรณีที่คำขอ API ล้มเหลว ซึ่งมีโอกาสน้อย แอปพลิเคชันของคุณจะได้รับรหัสสถานะ HTTP
คำตอบ รหัสสถานะ HTTP 403 มีข้อมูลข้อผิดพลาดที่ระบุว่าโควต้า API ใด
เกินขีดจำกัดแล้ว การตอบกลับจะช่วยให้แอปพลิเคชันที่กำหนดเองสามารถตรวจหาข้อผิดพลาดและดำเนินการ
การดำเนินการ
คำขอที่อิงตามเวลา
หากต้องดำเนินการตามคำขอให้เสร็จภายในระยะเวลาที่กำหนด ให้ส่งคำขอพร้อมกัน หรือใช้เธรดหลายรายการในแอปพลิเคชัน Java หรือ C# ของคุณ ตัวอย่างเช่น แยกคำขอตามเดือน หรือ ช่วงเวลาอื่น ในกรณีที่มีชุดข้อความ ให้ลองเริ่มด้วยชุดข้อความ 10 รายการ แล้วคำขอละ 1 ชุดข้อความ คำแนะนำเทรดมีข้อดีและข้อเสียไม่มีประโยชน์สำหรับ API บางกรณี หากจำนวนของ คำขอสูงเกินไป เกิดข้อผิดพลาดในโควต้า
ข้อผิดพลาดตามเวลา
สำหรับข้อผิดพลาดทั้งหมดที่ขึ้นกับเวลา (ไม่เกิน N รายการสำหรับ X วินาทีต่อชุดข้อความ) โดยเฉพาะ
503 ข้อผิดพลาดเกี่ยวกับรหัสสถานะ เราขอแนะนำว่าโค้ดของคุณควรรับข้อยกเว้นดังกล่าว และโดยใช้
CANNOT TRANSLATE
Exponential Backoff
โปรดรอสักพักก่อนที่จะลองเรียกใช้ที่ล้มเหลวอีกครั้ง ตัวอย่าง Groups Settings API สำหรับ
เทรด 1 รายการให้รอ 5 วินาทีแล้วลองเรียกใช้ที่ล้มเหลวอีกครั้ง หากคำขอประสบความสำเร็จ ให้ทำขั้นตอนนี้ซ้ำ
สำหรับชุดข้อความอื่นๆ หากคำขอที่สองไม่ประสบความสำเร็จ ใบสมัครของคุณควร
ลดความถี่ของคำขอจนกว่าการโทรจะสำเร็จ เช่น เพิ่ม
หน่วงเวลา 5 วินาทีแรกถึง 10 วินาที แล้วลองเรียกที่ล้มเหลวอีกครั้ง และตัดสินใจว่าจะลองอีกครั้งด้วย
ขีดจำกัด เช่น ลองส่งคำขออีกครั้ง 5-7 ครั้งโดยมีความล่าช้าแตกต่างกันไปก่อนสมัคร
แสดงข้อผิดพลาดให้แก่ผู้ใช้
โควต้า
| หมวดหมู่โควต้า API | โควต้า |
|---|---|
| การค้นหาต่อวัน | คุณสามารถสร้างข้อความค้นหาได้สูงสุด 100,000 ข้อความต่อวัน หากคุณต้องการความจุมากกว่า คุณสามารถส่งคำขอจาก หน้าโควต้าในคอนโซล Google Cloud |
| คำอธิบายกลุ่ม, ขนาดสูงสุด | คุณป้อนคำอธิบายกลุ่มได้สูงสุด 4,096 อักขระ |
| ชื่อกลุ่ม, ขนาดสูงสุด | ชื่อกลุ่มมีอักขระได้สูงสุด 60 ตัว |
defaultMessageDenyNotificationText |
โดยข้อความแจ้งเตือนนั้นมีอักขระได้ไม่เกิน 10,000 ตัว หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับ
พร็อพเพอร์ตี้ defaultMessageDenyNotificationText โปรดดู
การอ้างอิง API
|
maxMessageBytes |
ขนาดสูงสุดของข้อความเริ่มต้นคือ 1 MB ดูข้อมูลเพิ่มเติมเกี่ยวกับmaxMessageBytes
โปรดดูข้อมูลอ้างอิง API
|
จำกัดสูงสุด
| ประเภทของขีดจำกัด | ข้อจำกัดและหลักเกณฑ์ |
|---|---|
| รูปแบบข้อมูล ค่าเริ่มต้น |
รูปแบบข้อมูลเริ่มต้นคือ JSON นอกจากนี้ API ยังรองรับรูปแบบ Atom ด้วย ทั้ง JSON และ Atom รูปแบบข้อมูลสนับสนุนความสามารถในการอ่านและเขียนเต็มรูปแบบ สำหรับข้อมูลเพิ่มเติม โปรดดู รูปแบบข้อมูล JSON และ Atom |
| Groups Settings API, การเปิดใช้งาน | คุณต้องเปิด Directory API ก่อนที่จะเรียกใช้ Groups Settings API โปรดดูข้อมูลที่หัวข้อเปิดใช้ Google Workspace API |