מגבלות שימוש

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

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

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

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

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

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

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

ה-methods של Chat API

מגבלה (ל-60 שניות)

כתיבת הודעות בדקה

spaces.messages.create

spaces.messages.patch

spaces.messages.delete

3000

קריאות של הודעות בדקה

spaces.messages.get

spaces.messages.list

3000

חיפושי הודעות בדקה

spaces.messages.search

300

פעולות כתיבה של חברות בקבוצה לדקה

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

spaces.search

3000

פעולות קריאה של חיפוש מרחבים לדקה (ללא הרשאות אדמין)

spaces.search

300

כתיבת קבצים מצורפים בדקה

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

קריאות של CustomEmoji לדקה

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

פעולות כתיבה של מצב קריאה בדקה

users.spaces.updateSpaceReadState

users.spaces.threads.updateThreadReadState

3000

קריאות של מצב קריאה לדקה

users.spaces.getSpaceReadState

users.spaces.threads.getThreadReadState

3000

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

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

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

מכסה לכל מרחב משותף

ה-methods של 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 (מגבלות נוספות חלות על תגובות לפעולות לפיתוח האפליקציה (webhook) נכנסות)

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 בשם המשתמש (באמצעות אימות משתמש).

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

מכסה לכל משתמש

ה-methods של Chat API

מגבלה (לשנייה)

פעולות כתיבה של CustomEmoji לשנייה

customEmojis.create

customEmojis.delete

1

פעולות קריאה של CustomEmoji לשנייה

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 דקות), מומלץ שהקוד יתפוס את החריגה וישתמש בהשהיה מעריכית קטועה לפני ניסיון חוזר (truncated exponential backoff) כדי לוודא שהמכשירים לא יוצרים עומס מוגזם.

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

כאשר:

  • זמן ההמתנה הוא 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.

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

מכסות לשרתי MCP ב-Chat

שרת ה-MCP של Chat משתמש במדד של הקצאת עלות לשאילתה. בטבלאות הבאות מפורטת עלות השאילתה לכל שיטה של שרת MCP ב-Chat, לפי קטע:

מכסות MCP ב-Chat

יש שני סוגים של מכסות:

  • לדקה לפרויקט: עלות השאילתה לפרויקט ב-Google Cloud לדקה.

  • לדקה לכל משתמש בכל פרויקט: עלות השאילתה לפרויקט ב-Google Cloud לדקה, שכל משתמש ספציפי יכול להשתמש בה.

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

סוג מגבלת השימוש עלות השאילתה
לדקה לכל פרויקט 3,000
לדקה לכל משתמש בכל פרויקט 300

מכסות לערכת הכלים של MCP ב-Chat

בטבלה הבאה מפורטת עלות השאילתה לכל ערכת כלים של chatmcp.googleapis.com:

נקודת קצה

כלי

עלות השאילתה

‎/mcp/v1

list_messages

1

search_conversations

10

search_messages

10

send_message

10

מידע נוסף זמין במאמרי העזרה של Chat MCP API.