מגבלות ומכסות מגנות על התשתית של Google מפני תהליך אוטומטי שמשתמש ב-Admin Settings API בצורה לא הולמת. יכול להיות ששליחת בקשות מרובות מדי מ-API נובעת משגיאת הקלדה תמימה, או ממערכת לא יעילה ששולחת קריאות מיותרות ל-API. לא משנה מה הסיבה, חסימת תנועה ממקור מסוים ברגע שהיא מגיעה לרמה מסוימת היא הכרחית כדי לשמור על תקינות המערכת של Google Workspace. היא מבטיחה שפעולות של מפתח אחד לא ישפיעו לרעה על הקהילה הרחבה יותר.
במקרה הלא סביר שבקשת ה-API תיכשל, תקבלו תגובה עם קוד סטטוס HTTP. קוד סטטוס 403 כולל מידע על שגיאה שקשורה לקלט שגוי, וקוד סטטוס 503 של HTTP כולל מידע על שגיאה שמציין אילו מכסות של API חרגו. התגובות האלה מאפשרות לאפליקציה המותאמת אישית לזהות את השגיאות האלה ולפעול בהתאם.
אם הבקשות שלכם צריכות להסתיים בפרק זמן קבוע, אתם יכולים לשלוח את הבקשות במקביל או להשתמש בכמה שרשורים באפליקציית Java או C#. לדוגמה, אפשר לפצל את הבקשות לפי חודש או לפי תקופת זמן אחרת. במקרה של שרשורים, כדאי להתחיל עם 10 שרשורים, שרשור אחד לכל בקשה. הערה: להמלצה על שרשור יש חסרונות, והיא לא שימושית בכל המצבים שקשורים ל-API. אם מספר הבקשות יהיה גבוה מדי, יתרחשו שגיאות שקשורות למכסה.
לגבי כל השגיאות שמבוססות על זמן (מקסימום N פריטים למשך X שניות לכל thread), במיוחד שגיאות עם קוד סטטוס 503, מומלץ שהקוד יתפוס את החריגה וישתמש באלגוריתם של נסיגה אקספוננציאלית כדי להמתין פרק זמן קצר לפני ניסיון חוזר של הקריאה שנכשלה. דוגמה לשימוש ב-Email Settings API עבור שרשור אחד היא להמתין 5 שניות ולנסות שוב את הקריאה שנכשלה. אם הבקשה מצליחה, חוזרים על התהליך הזה עבור שאר השרשורים. אם הבקשה השנייה לא מצליחה, האפליקציה צריכה להקטין את תדירות הבקשות עד שהשיחה תצליח. לדוגמה, אפשר להגדיל את העיכוב הראשוני של 5 שניות ל-10 שניות ולנסות שוב את השיחה שנכשלה. בנוסף, צריך להגדיר מגבלת ניסיונות חוזרים. לדוגמה, כדאי לנסות לשלוח בקשה 5 עד 7 פעמים עם זמני השהיה שונים לפני שהאפליקציה מחזירה שגיאה למשתמש.
| קטגוריות של מכסות ל-API | מכסות |
|---|---|
| טוקנים של אימות ClientLogin | בתוקף ל-24 שעות. השגיאה היא '401 פג תוקף הטוקן'. |
| יצירת מפתחות ציבוריים ופרטיים |
בעזרת ספק הזהויות, יוצרים קבוצה של מפתחות ציבוריים ופרטיים באמצעות אלגוריתם DSA או RSA. המפתח הציבורי הוא אישור בפורמט X.509. מידע נוסף על מפתחות חתימה של כניסה יחידה (SSO) שמבוססת על SAML זמין במאמר יצירת מפתחות ואישורים לשירות הכניסה היחידה של Google Workspace. |
| לוגו |
קובץ תמונת הלוגו של החשבון יכול להיות בפורמט JPEG, PNG או GIF. הגודל המומלץ הוא 143 x 59 פיקסלים, והקובץ צריך להיות קטן מ-20KB. כשמשתמשים בלוגו בהתאמה אישית, חשוב לזכור לפעול בהתאם לתנאים ולהגבלות של Google. בנוסף, אל תשתמשו בלוגו של Google, בלוגו של Gmail או בלוגו אחר של Google. מידע נוסף זמין במאמר בנושא המדיניות בנושא לוגו ודף נחיתה. |
| ssoWhitelist |
רשימת היתרים ל-SSO היא כתובת IP של מסכת רשת בפורמט Classless Inter-Domain Routing (CIDR). |
| סוגים אחרים של מגבלות | מגבלות והנחיות |
|---|---|
| סטטוס האימות של רשומת MX |
סטטוס האימות של רשומת ה-MX שמוגדר כברירת מחדל הוא false, כלומר או שמערכת Google לא בדקה לאחרונה את ההגדרה של רשומת ה-MX, או שרשומות ה-MX לא הוגדרו להפניה למערכות של Google. אם עדכנתם את הרשומות וסטטוס האימות נשאר false, יכול להיות שהעדכונים של רשומת ה-MX לא הועברו, או שיש טעות הקלדה ברשומה. כדי שהשינוי יתעדכן, מומלץ להמתין את משך הזמן שמוגדר בערך Time To Live (TTL) של רשומת ה-MX ולנסות שוב. |
| קודי מדינה |
אם לא התאמתם אישית את שם הארגון, ברירת המחדל היא שם הדומיין הראשי שלכם. למידע על התווים בשם הארגון, אפשר לעיין במאמר שימוש בתווים. |
מאפיין creationTime, ייצוג מספרי של תאריכים ושעות |
אפשר לעיין בתקן ISO 8601 בנושא ייצוג מספרי של תאריכים ושעות. |
| תגים של קידוד שפה |
אפשר לעיין בתגי השפה RFC 3066 שמתקבלים ב-Google Mail. |
| שם הארגון |
אם לא התאמתם אישית את שם הארגון, ברירת המחדל היא שם הדומיין הראשי שלכם. למידע על התווים בשם הארגון, אפשר לעיין במאמר שימוש בתווים. |
בקשה להגדלת מכסה לפרויקט
יכול להיות שתרצו לבקש שינוי במכסות בהתאם לשימוש במשאבים בפרויקט. קריאות ל-API על ידי חשבון שירות נחשבות לשימוש בחשבון יחיד. הגשת בקשה למכסה מותאמת לא מבטיחה שהבקשה תאושר. יכול להיות שיעבור יותר זמן עד שנאשר בקשות להתאמת מכסות שיובילו להגדלה משמעותית של ערך המכסה.
המכסות לא זהות בכל הפרויקטים. ככל שהשימוש שלכם ב-Google Cloud יגדל עם הזמן, יכול להיות שתצטרכו להגדיל את ערכי המכסות. אם אתם צופים עלייה משמעותית בשימוש בקרוב, תוכלו לבקש התאמות במכסות מראש בדף Quotas במסוף Google Cloud.
מידע נוסף זמין במשאבים הבאים: