מגבלות שימוש

ממשק 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
כתיבות של סמלי אמוג'י מותאמים אישית בדקה	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

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

מכסות לכל מרחב מגבילות את קצב השאילתות במרחב נתון, והן משותפות לכל אפליקציות 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	1
קריאות של קטע בשנייה	users.sections.list users.sections.items.list	15

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

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

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

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

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

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

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