מערכת מכסות הוטמעה בממשקי ה-API של Home כדי להבטיח את מהימנות השירות ולעזור למפתחים לנהל ביעילות את נפח התנועה. המכסות בממשקי ה-API של Home הן ברמת הפרויקט ב-Google Cloud.
הגבלת הקצב של ממשקי ה-API של Home היא 30,000 שאילתות לדקה לכל פרויקט. המגבלה הזו כוללת את כל השאילתות שנשלחות דרך ממשקי ה-API של Home.
חריגה מהמכסה
אם חורגים ממגבלת הקצב של יצירת הבקשות ב-Home APIs, מוצגת השגיאה
resourceExhaused
HomeError. בקשות נוספות יידחו באופן מיידי עם ההודעה 'חריגה מהמכסה'.
אם חורגים מהמכסה, האפליקציות צריכות להשתמש בהשהיה מעריכית לפני ניסיון חוזר (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 של שירות Home API בפרויקט Google Cloud שמשויך לרישום האפליקציה ב-Developer Console.
כדי לבקש הגדלה, עורכים מכסה ספציפית. הוראות מפורטות מופיעות במאמר בנושא בקשת שינוי של מכסת נפח האחסון במסמכי התיעוד של Google Cloud.