מכסות ומגבלות שימוש

ההגבלות והמכסות מגנות על התשתית של Google מפני תהליכים אוטומטיים שמשתמשים ב-Reseller API בצורה לא הולמת. בקשות מוגזמות עשויות לנבוע משגיאת הקלדה או מעיצוב לא יעיל של המערכת. כדי לשמור על תקינות המערכת של Google Workspace, ‏ Google חוסמת תנועה ממקורות ספציפיים כשהיא מגיעה לרמות מסוימות. כך מוודאים שהפעולות של מפתח אחד לא ישפיעו לרעה על הקהילה.

בקשות API שנכשלו

אם בקשת API נכשלת, האפליקציה מקבלת קוד סטטוס של HTTP. קוד סטטוס 403 מציין שהקלט שגוי, וקוד סטטוס 503 מציין שהמכסות של ה-API חרגו. אפשר להשתמש בתשובות האלה כדי לזהות שגיאות ולפעול בהתאם.

שגיאות שקשורות לזמן

בשגיאות שקשורות לזמן, במיוחד קודי סטטוס 503, צריך להשתמש באלגוריתם של השהיה מעריכית לפני ניסיון חוזר (exponential backoff). מחכים כמה שניות ואז מנסים שוב להתקשר. לדוגמה, מחכים 5 שניות ומנסים שוב. אם הפעולה בוצעה ללא שגיאות, חוזרים על התבנית עבור שרשורים אחרים. אם הבקשה השנייה נכשלת, צריך להקטין את תדירות הבקשות עד שהשיחה תצליח. מומלץ גם להגדיר מגבלת ניסיונות חוזרים, למשל 5 עד 7 פעמים.

מגבלות

קטגוריות של מגבלות על ממשקי API	מגבלות
מינוי purchaseOrderId	אפשר להזין בנכס הזה עד 80 תווים של טקסט רגיל.
מינוי maxResults	מחרוזת השאילתה maxResults יכולה להניב 1 עד 100 תוצאות. ברירת המחדל היא 20 תוצאות.
טוקן העברה (customerAuthToken)	אסימון ההעברה של לקוח תקף למשך 30 ימים אחרי שהוא נוצר.
מספר המשתמשים המקסימלי ללקוח	בהתאם לחוזה שלכם, המספר המקסימלי של משתמשים יכול להיות 50,000 או המספר המקסימלי שמוגדר בחוזה עם המפיץ.
בקשות לא מורשות	‫Google לא מאפשרת בקשות לא מורשות ל-Reseller API. בקשה לא מורשית אם לא צוין טוקן הרשאה. מידע נוסף זמין במאמר מידע על אימות והרשאה.

סוגים אחרים של מגבלות

סוגים אחרים של מגבלות	הגבלות והנחיות
פורמט נתונים	פורמט הנתונים הוא JavaScript Object Notation ‏(JSON). ‫JSON הוא פורמט אינטרנט נפוץ לייצוג של מבני נתונים שרירותיים. זוהי פורמט טקסט שאינו תלוי בשפה, שמשתמש במוסכמות שמוכרות למתכנתים בשפות ממשפחת C, כולל C, ‏ C++‎,‏ C#‎, ‏ Java, ‏ JavaScript, ‏ Perl ו-Python.
פורמט זמן	התאריכים והשעות מבוססים על המרת ראשית זמן יוניקס (Unix epoch) באלפיות השנייה. הפורמט הזה חל על שעת יצירת המינוי, על שעות ההתחלה והסיום של ההתחייבות לתוכנית ועל שעות הסיום של תקופת הניסיון בחינם.