מגבלות שימוש

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

אם תחרגו ממכסה, תקבלו תשובה עם קוד הסטטוס 429: Too many requests‏ HTTP. יכול להיות שגם בדיקות נוספות של מגבלות קצב בשרת העורפי של Chat יגרמו לאותה תגובה עם שגיאה. אם השגיאה הזו מתרחשת, צריך להשתמש באלגוריתם של השהיה מעריכית לפני ניסיון חוזר ולנסות שוב מאוחר יותר. כל עוד אתם לא חורגים מהמכסות לדקה שמפורטות בטבלאות הבאות, אין הגבלה על מספר הבקשות שאתם יכולים לשלוח ביום.

יכול להיות שסוגים שונים של מכסות יחולו על שיטות של Chat API: מכסות לכל פרויקט, לכל מרחב ולכל משתמש.

מכסות לכל פרויקט

מכסות לכל פרויקט מגבילות את קצב השאילתות לפרויקט ב-Google Cloud, ולכן הן חלות על אפליקציית Chat יחידה שקוראת לשיטות ספציפיות של Chat API עבור כל מכסה.

בטבלה הבאה מפורטות מגבלות השאילתות לכל פרויקט. אפשר לראות את המגבלות האלה גם בדף Quotas.

מכסה לכל פרויקט	שיטות של Chat API	מגבלה (לכל 60 שניות)
כתיבות של הודעות בדקה	spaces.messages.create spaces.messages.patch spaces.messages.delete	3000
קריאת הודעות בדקה	spaces.messages.get spaces.messages.list	3000
מספר הכתיבות בדקה של חברי מועדון	spaces.members.create spaces.members.delete	300
קריאות בדקה של חברים במועדון	spaces.members.get spaces.members.list	3000
כתיבות במרחב לדקה	spaces.setup spaces.create spaces.patch spaces.delete	60
קריאת רווחים בדקה	spaces.get spaces.list spaces.findDirectMessage	3000
כתיבות של קבצים מצורפים לדקה	media.upload	600
קריאות של קבצים מצורפים בדקה	spaces.messages.attachments.get media.download	3000
מספר הפעמים שמשתמשים באמוג'י לתגובה לדקה	spaces.messages.reactions.create spaces.messages.reactions.delete	600
מספר התגובות לדקה	spaces.messages.reactions.list	3000
CustomEmoji writes per minute	customEmojis.create customEmojis.delete	600
מספר הקראות של סמלי אמוג'י מותאמים אישית בדקה	customEmojis.get customEmojis.list	3000
כתיבות לקטע בדקה	users.sections.create users.sections.delete users.sections.patch users.sections.position users.sections.items.move	600
קריאות של קטע בדקה	users.sections.list users.sections.items.list	3000
קריאות זמינות בדקה	users.availability.get	3000
מספר הכתיבות של נתוני הזמינות בדקה	users.availability.update users.availability.markAsActive users.availability.markAsAway users.availability.markAsDoNotDisturb	3000

מכסות לכל מרחב

מכסות לכל מרחב מגבילות את קצב השאילתות במרחב נתון, והן משותפות לכל אפליקציות Chat שפועלות במרחב הזה ומבצעות קריאות לשיטות Chat API שמופיעות בכל מכסה.

בטבלה הבאה מפורטות מגבלות השאילתות לכל מרחב:

מכסה לכל מרחב	שיטות של Chat API	מגבלה (לשנייה)
קריאות לשנייה	media.download spaces.get spaces.members.get spaces.members.list spaces.messages.get spaces.messages.list spaces.messages.attachments.get spaces.messages.reactions.list	15
פעולות כתיבה לשנייה	media.upload spaces.delete spaces.patch spaces.messages.create (חלות מגבלות נוספות על webhooks נכנסים) spaces.messages.delete spaces.messages.patch spaces.messages.reactions.delete	1
יצירת כתיבות של תגובות בשנייה	spaces.messages.reactions.create	5
מספר הפעמים שהודעה נכתבת בשנייה בזמן ייבוא נתונים ל-Google Chat	spaces.messages.create	10

מכסות לכל משתמש

מכסות לכל משתמש מגבילות את קצב השאילתות של משתמש ב-Google Chat. השאילתות מתייחסות לכל אפליקציות Chat שמבצעות קריאה לשיטה של Chat API בשם משתמש (באמצעות אימות משתמש).

בטבלה הבאה מפורטות מכסות השאילתות לכל משתמש:

מכסה לכל משתמש	שיטות של Chat API	מגבלה (לשנייה)
כתיבות של סמלי אמוג'י בהתאמה אישית בשנייה	customEmojis.create customEmojis.delete	1
קריאות של סמלי אמוג'י מותאמים אישית בשנייה	customEmojis.get customEmojis.list	15
פעולות כתיבה לשנייה	users.sections.create users.sections.delete users.sections.patch users.sections.position users.sections.items.move users.availability.update users.availability.markAsActive users.availability.markAsAway users.availability.markAsDoNotDisturb	1
קריאות לשנייה	users.sections.list users.sections.items.list users.availability.get	15

מגבלות שימוש נוספות

תנועה גבוהה של בקשות ל-API שמטרגטת את אותו מרחב יכולה להפעיל מגבלות פנימיות נוספות שלא מוצגות בדף Quotas.

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

לגבי כל השגיאות שמבוססות על זמן (מקסימום N בקשות לכל X דקות), מומלץ שהקוד יזהה את החריגה וישתמש בנסיגה אקספוננציאלית קטומה כדי לוודא שהמכשירים לא יוצרים עומס מוגזם.

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

אלגוריתם לדוגמה

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

1. שולחים בקשה ל-Google Chat API.
2. אם הבקשה נכשלת, צריך להמתין ‎1 + random_number_milliseconds‎ שניות ולנסות שוב את הבקשה.
3. אם הבקשה נכשלת, צריך להמתין ‎2 + random_number_milliseconds‎ שניות ולנסות שוב את הבקשה.
4. אם הבקשה נכשלת, צריך להמתין ‎4 + random_number_milliseconds‎ שניות ולנסות שוב את הבקשה.
5. וכך הלאה, עד maximum_backoff פעמים.
6. ממשיכים להמתין ולנסות שוב עד שמגיעים למספר מקסימלי מסוים של ניסיונות חוזרים, אבל לא מגדילים את תקופת ההמתנה בין הניסיונות החוזרים.

where:

• זמן ההמתנה הוא min(((2^n)+random_number_milliseconds), maximum_backoff), שבו n גדל ב-1 בכל איטרציה (בקשה).
• ‫random_number_milliseconds הוא מספר אקראי של אלפיות השנייה שקטן מ-1,000 או שווה לו. ההשהיה הזו עוזרת למנוע מצבים שבהם הרבה לקוחות מסונכרנים בגלל סיטואציה מסוימת, וכולם מנסים לשלוח בקשות בו-זמנית. הערך של random_number_milliseconds מחושב מחדש אחרי כל בקשה לניסיון חוזר.
• בדרך כלל, maximum_backoff הוא 32 או 64 שניות. הערך המתאים תלוי בתרחיש לדוגמה.

הלקוח יכול להמשיך לנסות שוב אחרי שהגיע לזמן maximum_backoff. ניסיונות חוזרים אחרי הנקודה הזו לא צריכים להמשיך להגדיל את זמן ההמתנה. לדוגמה, אם הלקוח משתמש בזמן maximum_backoff של 64 שניות, אחרי שהערך הזה יגיע, הלקוח יוכל לנסות שוב כל 64 שניות. בשלב מסוים, צריך למנוע מהלקוחות לנסות שוב ללא הגבלת זמן.

זמן ההמתנה בין ניסיונות חוזרים ומספר הניסיונות החוזרים תלויים בתרחיש לדוגמה ובתנאי הרשת.

בקשה להגדלת מכסה לפרויקט

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

המכסות לא זהות בכל הפרויקטים. ככל שהשימוש שלכם ב-Google Cloud יגדל עם הזמן, יכול להיות שתצטרכו להגדיל את ערכי המכסות. אם צפויה עלייה משמעותית בשימוש, אפשר לבקש התאמות של המכסות מראש בדף Quotas & System Limits (מכסות ומגבלות מערכת) במסוף Google Cloud.

מידע נוסף זמין במקורות המידע הבאים:

• מידע על שינוי מכסות
• איך רואים את השימוש במכסות ואת המגבלות
• איך מבקשים להגדיל את המכסות