ขีดจำกัดและโควต้าจะปกป้องโครงสร้างพื้นฐานของ Google จากกระบวนการอัตโนมัติที่ใช้ Groups Migration API ในลักษณะที่ไม่เหมาะสม คำขอที่มากเกินไปจาก API อาจเป็นผลมาจากการพิมพ์ผิดที่ไม่เป็นอันตราย หรือมาจากระบบที่ออกแบบมาอย่างไม่มีประสิทธิภาพซึ่งทำการเรียก API โดยไม่จำเป็น ไม่ว่าจะเกิดจากสาเหตุใด การบล็อกการเข้าชมจากแหล่งที่มาที่เฉพาะเจาะจงเมื่อถึงระดับหนึ่งๆ จำเป็นต่อประสิทธิภาพโดยรวมของระบบ Google Workspace
คำขอ API ล้มเหลว
ในกรณีที่คำขอ API ของคุณไม่สำเร็จ ซึ่งมีโอกาสเกิดขึ้นไม่บ่อยนัก แอปพลิเคชันของคุณจะได้รับการตอบกลับรหัสสถานะ HTTP รหัสสถานะ HTTP ของ 403 มีข้อมูลข้อผิดพลาดเกี่ยวกับอินพุตที่ไม่ถูกต้อง และรหัสสถานะ HTTP ของ 503 มีข้อมูลข้อผิดพลาดที่ระบุว่าโควต้า API ใดใช้เกินโควต้า การตอบกลับเหล่านี้จะช่วยให้แอปพลิเคชันที่กำหนดเองตรวจหาข้อผิดพลาดเหล่านี้และดำเนินการได้อย่างเหมาะสม
คำขอที่มีกำหนดเวลา
หากต้องดำเนินการตามคำขอให้เสร็จในระยะเวลาที่กำหนด ให้ส่งคำขอพร้อมกันหรือใช้เทรดหลายรายการในแอปพลิเคชัน Java หรือ C# ตัวอย่างเช่น แยกคำขอตามเดือนหรือ ช่วงเวลาอื่น ในกรณีของชุดข้อความ ให้ลองเริ่มจากชุดข้อความ 10 รายการ โดยป้อน 1 ชุดข้อความต่อคําขอ คำแนะนำชุดข้อความมีข้อดีข้อเสียและไม่มีประโยชน์ต่อ API บางสถานการณ์ หากจำนวนคำขอสูงเกินไป ข้อผิดพลาดโควต้าจะเกิดขึ้น
ข้อผิดพลาดที่อิงตามเวลา
สำหรับข้อผิดพลาดทั้งหมดที่อิงตามเวลา (ไม่เกิน N รายการเป็นเวลา X วินาทีต่อเทรด) โดยเฉพาะอย่างยิ่งข้อผิดพลาดของรหัสสถานะ 503 เราขอแนะนำให้โค้ดจับข้อยกเว้น และรอโดยใช้อัลกอริทึม Exponential Backoff ก่อนที่จะลองเรียกที่ไม่สำเร็จอีกครั้ง ตัวอย่าง API การย้ายข้อมูล Groups สำหรับชุดข้อความหนึ่งคือ ให้รอ 5 วินาทีแล้วลองเรียกที่ล้มเหลวอีกครั้ง หากคำขอประสบความสำเร็จ ให้ใช้รูปแบบนี้ซ้ำสำหรับชุดข้อความอื่นๆ หากคำขอที่ 2 ไม่สำเร็จ แอปพลิเคชันควรปรับลดความถี่ของคำขอจนกว่าคำขอจะสำเร็จ ตัวอย่างเช่น เพิ่มการหน่วงเวลาเริ่มต้น 5 วินาทีเป็น 10 วินาที แล้วลองโทรที่ไม่สำเร็จอีกครั้ง นอกจากนี้ ให้เลือกขีดจำกัดการลองอีกครั้ง สำหรับ ]
ลองส่งคำขออีกครั้ง 5 ถึง 7 ครั้งโดยให้เวลาล่าช้าต่างกันไปก่อนที่แอปพลิเคชันจะแสดงข้อผิดพลาดให้แก่ผู้ใช้
ข้อจำกัด
| หมวดหมู่ขีดจำกัด API | ข้อจำกัด |
|---|---|
| จำนวนคำค้นหาต่อวินาที (QPS) | โปรเจ็กต์นักพัฒนาซอฟต์แวร์จำกัดไว้ที่ 10 คำค้นหาต่อวินาที (QPS) ต่อบัญชี |
โควต้า
| หมวดหมู่โควต้า API | โควต้า |
|---|---|
| คำขอ API สูงสุดต่อวัน | คำขอ API สูงสุดต่อวันคือ 500,000 รายการ |
| การเก็บ การหมดอายุของข้อความ | ที่เก็บถาวรของกลุ่มไม่มีวันหมดอายุ ข้อความจะคงอยู่ในที่เก็บจนกว่ากลุ่มจะถูกลบ นโยบายการเก็บรักษาอีเมลจะไม่ส่งผลต่อข้อความในที่เก็บถาวรของกลุ่ม |
| ขนาดข้อความอีเมล | ขนาดข้อความอีเมลสูงสุดคือ 25 MB ขีดจำกัดนี้รวมถึงส่วนหัวข้อมูลเมตา เนื้อหา และไฟล์แนบทั้งหมดของข้อความ |
ข้อจำกัดประเภทอื่นๆ
| ข้อจำกัดอื่นๆ | ข้อจำกัดและหลักเกณฑ์ |
|---|---|
| รูปแบบประเภทเนื้อหา | ข้อความอีเมลต้องอยู่ในรูปแบบข้อความ RFC 822 มาตรฐาน
เมื่ออัปโหลดอีเมลที่ย้ายข้อมูลแล้ว ประเภทเนื้อหาของคำขอต้องใช้ส่วนหัว Content-type: message/rfc822
|
| รูปแบบข้อมูลในการตอบสนองของ API | รูปแบบข้อมูลการตอบกลับคือ JavaScript Object Notation (JSON) |
| นโยบายตำแหน่งข้อมูล | API การย้ายข้อมูล Groups ไม่รองรับนโยบายตำแหน่งข้อมูลที่กำหนดให้ต้องจัดเก็บข้อมูลในเขตแดนทางภูมิศาสตร์หรือการเมืองที่เฉพาะเจาะจงด้วยเหตุผลทางสัญญา อย่าใช้ Groups Migration API หากจำเป็นต้องใช้ตำแหน่งข้อมูลสำหรับบัญชีของคุณ |
| การแทรกข้อความพร้อมกัน | API การย้ายข้อมูล Groups รองรับคำขอพร้อมกันสำหรับการแทรกอีเมลในที่เก็บถาวรของกลุ่มต่างๆ แต่ Groups Migration API ไม่รองรับการแทรกข้อความพร้อมกันในที่เก็บถาวรกลุ่มเดียวกัน นอกจากนี้ Groups Migration API ยังไม่รองรับคำขอแบบกลุ่ม |
| คำขอที่ไม่ได้รับอนุญาต | Groups Migration API จะไม่ยอมรับคำขอที่ไม่ได้รับอนุญาต ระบบจะถือว่าคำขอไม่ได้รับอนุญาตหากไม่มีการระบุโทเค็นการให้สิทธิ์ ดูข้อมูลเพิ่มเติมได้ที่เรียนรู้เกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์ |