מגבלות ומכסות מגנות על התשתית של Google מפני תהליך אוטומטי שמשתמש ב-Admin Settings API בצורה לא הולמת. יכול להיות ששליחת בקשות מרובות מדי מ-API נובעת משגיאת הקלדה תמימה, או ממערכת לא יעילה ששולחת קריאות מיותרות ל-API. לא משנה מה הסיבה, חסימת תנועה ממקור ספציפי ברגע שהיא מגיעה לרמה מסוימת היא הכרחית כדי לשמור על תקינות המערכת של Google Workspace. היא מבטיחה שפעולות של מפתח אחד לא ישפיעו לרעה על הקהילה הרחבה יותר.
במקרה הלא סביר שבקשת ה-API תיכשל, תקבלו תגובה עם קוד סטטוס HTTP. קוד סטטוס 403 כולל מידע על שגיאה שקשורה לקלט שגוי, וקוד סטטוס של HTTP 503 כולל מידע על שגיאה שמציין אילו מכסות של API חרגו. התשובות האלה מאפשרות לאפליקציה המותאמת אישית לזהות את השגיאות ולפעול בהתאם.
אם הבקשות שלכם צריכות להסתיים בפרק זמן קבוע, אתם יכולים לשלוח את הבקשות במקביל או להשתמש בכמה שרשורים באפליקציית Java או C#. לדוגמה, אפשר לפצל את הבקשות לפי חודש או לפי תקופת זמן אחרת. במקרה של שרשורים, כדאי להתחיל עם 10 שרשורים, שרשור אחד לכל בקשה. הערה: להמלצה על שרשור יש חסרונות, והיא לא שימושית בכל המצבים שקשורים ל-API. אם מספר הבקשות יהיה גבוה מדי, יתרחשו שגיאות שקשורות למכסה.
לגבי כל השגיאות שמבוססות על זמן (מקסימום N פריטים למשך X שניות לכל thread), במיוחד שגיאות עם קוד סטטוס 503, מומלץ שהקוד יתפוס את החריגה וישתמש באלגוריתם של השהיה מעריכית לפני ניסיון חוזר (exponential backoff) כדי להמתין פרק זמן קצר לפני ניסיון חוזר של הקריאה שנכשלה. דוגמה לשימוש ב-Email Settings API עבור שרשור אחד היא להמתין 5 שניות ולנסות שוב את הקריאה שנכשלה. אם הבקשה מצליחה, חוזרים על התהליך הזה עבור שאר השרשורים. אם הבקשה השנייה לא מצליחה, האפליקציה צריכה להקטין את תדירות הבקשות עד שהשיחה תצליח. לדוגמה, אפשר להגדיל את העיכוב הראשוני של 5 שניות ל-10 שניות ולנסות שוב את השיחה שנכשלה. בנוסף, צריך להגדיר מגבלת ניסיונות חוזרים. לדוגמה, כדאי לנסות לשלוח בקשה 5 עד 7 פעמים עם זמני השהיה שונים לפני שהאפליקציה מחזירה שגיאה למשתמש.
| קטגוריות של מכסות ל-API | מכסות |
|---|---|
| טוקנים של אימות ClientLogin | בתוקף ל-24 שעות. השגיאה היא '401 token expired' (פג תוקף הטוקן). |
| יצירת מפתחות ציבוריים ופרטיים |
בעזרת ספק הזהויות, יוצרים קבוצה של מפתחות ציבוריים ופרטיים באמצעות אלגוריתמים של 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.
מידע נוסף זמין במקורות המידע הבאים: