מערכת מכסות הוטמעה בממשקי ה-API של Home כדי להבטיח את מהימנות השירות ולעזור למפתחים לנהל ביעילות את נפח התעבורה. המכסות בממשקי ה-API של Home הן Google Cloudברמת הפרויקט.
מגבלת הקצב של ממשקי ה-API של Home היא 30,000 QPM (שאילתות לדקה) לכל פרויקט. המגבלה הזו כוללת את כל השאילתות שנשלחות דרך ממשקי ה-API של Home.
חריגה מהמכסה
כשחורגים ממגבלת הקצב של יצירת בקשות ב-Home APIs, מוצגת השגיאה
resourceExhaused
HomeException. בקשות נוספות יידחו באופן מיידי עם ההודעה 'חריגה מהמכסה'.
אם חורגים מהמכסה, האפליקציות צריכות להשתמש בהשהיה מעריכית לפני ניסיון חוזר (exponential backoff) ולהודיע למשתמשים אם הפעולות מוגבלות באופן זמני.
מעקב
אפשר להשתמש ב-Google Cloud Console כדי לעקוב אחרי השימוש בזמן אמת ולהגדיר התראות פרואקטיביות למקרים שבהם מתקרבים למכסה של Home APIs.
כדי לראות את המדדים הנוכחיים, עוברים אל הקטע Metrics של שירות Home API בפרויקט Google Cloud שמשויך לרישום האפליקציה ב-Google Home Developer Console.
הגדרת התראות
מומלץ שהשותפים יגדירו התראות על חריגה מסף (למשל 80%) של המכסה שהוקצתה לכם. התמיכה בהתראות ב-Google Cloud היא מקיפה מאוד וניתנת להגדרה במידה רבה.
כשיוצרים התראה לגבי מכסה, כדאי להשתמש במדדים הבאים בקטע Consumer Quota > Quota בכלי ליצירת מדיניות.
- השימוש במכסת ההקצאה – serviceruntime.googleapis.com/quota/allocation/usage
- מגבלת מכסה – serviceruntime.googleapis.com/quota/limit
מומלץ גם להגדיר ערוצי התראות (כמו אימייל) כדי לקבל התראות על מכסות.
כדי לקבל מידע נוסף על התראות ועל אופן ההגדרה שלהן ב-Google Cloud, אפשר לעיין במקורות המידע הבאים:
שליחת בקשה להגדלת המכסה
אם האפליקציה שלכם מקבלת תנועה לגיטימית שדורשת מכסות גבוהות יותר מהמכסה שמוגדרת כברירת מחדל, אתם יכולים לבקש להגדיל את המכסה.
כדי לראות את מכסות השימוש והמגבלות, עוברים אל Quotas & System Limits section of the Home API service בפרויקט Google Cloud שמשויך לרישום האפליקציה ב-Developer Console.
כדי לבקש הגדלה, עורכים מכסה ספציפית. הוראות מפורטות מופיעות במאמר בנושא בקשה לשינוי מכסת נפח האחסון במסמכי התיעוד של Google Cloud.