מגבלות שימוש

ממשק 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

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

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

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

מכסה לכל מרחב	שיטות של Chat API	מגבלה (לכל 60 שניות)
קריאות בדקה	media.download spaces.get spaces.members.get spaces.members.list spaces.messages.get spaces.messages.list spaces.messages.attachments.get spaces.messages.reactions.list	900
כתיבות בדקה	media.upload spaces.delete spaces.patch spaces.messages.create (חלות מגבלות נוספות על webhooks נכנסים) spaces.messages.delete spaces.messages.patch spaces.messages.reactions.create spaces.messages.reactions.delete	60

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

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

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

מכסה לכל משתמש	שיטות של Chat API	מגבלה (לכל 60 שניות)
קריאות בדקה	customEmojis.get customEmojis.list	900
כתיבות בדקה	customEmojis.create customEmojis.delete	60

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

יש מכסות נוספות ליצירת מרחבים מסוג GROUP_CHAT או SPACE (באמצעות השיטה spaces.create או השיטה spaces.setup). ליצור פחות מ-35 מרחבים בדקה ו-800 מרחבים בשעה מהסוגים האלה. במרחבים מהסוג DIRECT_MESSAGE לא חלות מגבלות המכסה הנוספות האלה.

תנועה גבוהה של בקשות ל-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 במסוף Google Cloud.

מידע נוסף זמין במשאבים הבאים:

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