כדי להבטיח את יציבות המערכת וחלוקה הוגנת של המשאבים, ב-Google Health API נאכפות מגבלות קצב על בקשות API נכנסות.
מכסות ברירת המחדל נועדו להתאים לרוב המכריע של תרחישי השימוש הרגילים, אבל אפליקציות שיחרגו מהמגבלות האלה יוגבלו.
טיפול בשגיאות זמניות ובשגיאות שקשורות למגבלת הקצב
אם האפליקציה חורגת ממגבלת הקצב שהוקצתה, ה-API דוחה את הבקשה ומחזיר את הקוד 429 Too Many Requests (RESOURCE_EXHAUSTED). בעיות זמניות בשרת יכולות גם להחזיר את הקוד 503 Service Unavailable (UNAVAILABLE) או 504 Gateway Timeout (DEADLINE_EXCEEDED).
כדי לטפל בתגובות האלה בצורה מהימנה בלי להגדיל את העומס, צריך להטמיע לוגיקה של ניסיון חוזר עם השהיה מעריכית לפני ניסיון חוזר (exponential backoff) ורעידות אקראיות בתגובות 429 RESOURCE_EXHAUSTED, 503 UNAVAILABLE ו-504 DEADLINE_EXCEEDED. אל תנסו שוב מיד, כי זה יגרום לעומס נוסף ויגביר את הסיכוי לוויסות קצב חוזר או לפסק זמן.
מגבלות ברירת המחדל וניתוח ההשפעות
מגבלות הקצב נבדקות במרווחי זמן יומיים, דקתיים ולכל משתמש. בניתוח ההשפעה מוסבר איך המכסות האלה מתורגמות לשאילתות לשנייה (QPS).
| מדד | מגבלת ברירת המחדל | ניתוח ההשפעה על ה-QPS |
|---|---|---|
| לכל פרויקט (יומי) | 86.4 מיליון בקשות ביום | ~1,000 שאילתות לשנייה (QPS) באופן קבוע |
| לכל פרויקט (לדקה) | 120,000 בקשות בדקה | כ-2,000 שאילתות לשנייה (QPS) בפרץ |
| לכל משתמש (לדקה) | 300 בקשות בדקה | רגיל: 5 שאילתות לשנייה לכל משתמש אפליקציות לא מאומתות: מקסימום 250 שאילתות לשנייה בסך הכול (מוגבל ל-100 משתמשים, 2.5 שאילתות לשנייה לכל משתמש) |
מגבלות קצב על הקצאת טוקנים של OAuth
Google Cloud אוכפת הגבלת קצב של יצירת בקשות על הענקת טוקנים של OAuth, כדי לשלוט בקצב שבו האפליקציה יכולה להוסיף משתמשים חדשים או לאמת מחדש משתמשים קיימים. אם אתם צופים שתחרגו מ-10,000 הרשמות או אימותים מחדש של משתמשים בחלון זמן של 24 שעות, בקשו מראש מכסה גדולה יותר. מידע נוסף זמין במאמר מגבלות קצב של יצירת בקשות באפליקציית OAuth.בקשה להגדלת המכסה
אם האפליקציה שלכם דורשת קצב העברת נתונים גבוה יותר מההקצאות שמוגדרות כברירת מחדל, אתם יכולים לבקש התאמה דרך מסוף Google Cloud. איך רואים ומנהלים את המכסות?