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

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

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

אם יש להשלים את הבקשות שלכם בפרק זמן קבוע, יש לשלוח את הבקשות במקביל או להשתמש במספר שרשורים באפליקציית Java או C# שלכם. לדוגמה, אפשר לחלק את הבקשות לפי חודש או לפי תקופת זמן אחרת. אם מדברים בשרשורים, מומלץ להתחיל ב-10 שרשורים, שרשור אחד לכל בקשה. הערה: להמלצה על שרשור יש יתרונות שונים והיא לא שימושית בכל המצבים ב-API. אם מספר הבקשות יהיה גבוה מדי, יחולו שגיאות הקשורות למכסות.

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

קטגוריות מכסה ל-API	מכסות
אסימוני אימות של התחברות לחשבון	תקף ל-24 שעות. השגיאה 'פג תוקף האסימון 401'.
יצירת מפתחות ציבוריים ופרטיים	באמצעות ספק הזהויות, יוצרים קבוצת מפתחות ציבוריים ופרטיים באמצעות האלגוריתמים DSA או RSA. המפתח הציבורי נמצא באישור בפורמט X.509. למידע נוסף על מפתחות לחתימה יחידה המבוססים על SAML, אפשר לעיין במאמר יצירת מפתחות ואישורים לשירות כניסה יחידה ב-Google Workspace.
לוגו	קובץ תמונת לוגו של חשבון יכול להיות בפורמט JPEG , PNG או GIF. הגודל המומלץ הוא 143 x 59 פיקסלים, וגודל הקובץ צריך להיות קטן מ-20Kb. כשמשתמשים בסמלי לוגו מותאמים אישית, חשוב לזכור לעמוד בתנאים ובהגבלות של Google. ולא להשתמש בלוגו של Google, בלוגו של Gmail או בכל לוגו אחר של Google. למידע נוסף, ניתן לעיין במדיניות בנושא סמלי לוגו ודפי נחיתה.
רשימת ההיתרים	רשימת ssoWhitelist היא כתובת IP של מסיכת רשת בפורמט Classless Inter-Domain Routing (CIDR).

סוגים אחרים של מגבלות	מגבלות והנחיות
סטטוס אימות של רשומת MX	סטטוס האימות של רשומת MX המוגדר כברירת מחדל הוא 'false'. כלומר, מערכת Google לא בדקה לאחרונה את תצורת רשומת ה-MX שלך, או שרשומות ה-MX שלך לא הוגדרו כך שמפנות למערכות Google. אם עדכנתם את הרשומות ושסטטוס האימות נשאר False, יכול להיות שהעדכונים של רשומת ה-MX לא הופצו או שיש שגיאת הקלדה ברשומה. כדי להפיץ, אנחנו ממליצים להמתין למשך הזמן שמוגדר על ידי ערך 'זמן עד להמרה (TTL)' של רשומת ה-MX ולנסות שוב.
קודי מדינה	אם שם הארגון לא הותאם אישית, ברירת המחדל היא שם הדומיין הראשי שלכם. כאן תוכלו לקרוא מידע נוסף על תווים של שמות ארגונים.
נכס של creationTime, ייצוג מספרי של תאריכים ושעות	ראו ISO 8601, ייצוג מספרי של תאריכים ושעות.
תגי קידוד שפה	מומלץ לעיין בתגי השפה ב-RFC 3066 ש-Google Mail מכבד.
שם הארגון	אם שם הארגון לא הותאם אישית, ברירת המחדל היא שם הדומיין הראשי שלכם. כאן תוכלו לקרוא מידע נוסף על תווים של שמות ארגונים.