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

ההגבלות והמכסות מגנות על התשתית של 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.
פורמט זמן	התאריכים והשעות מוצגים בפורמט של אלפיות השנייה באמצעות כלי להמרת ראשית זמן יוניקס. הפורמט הזה חל על שעת יצירת המינוי, על שעות ההתחלה והסיום של תקופת ההתחייבות לתוכנית ועל שעת הסיום של תקופת הניסיון בחינם.