הטמענו מערכת מכסות בממשקי Home API כדי להבטיח את אמינות השירות ולעזור למפתחים לנהל ביעילות את נפח התנועה. המכסות ב-Home APIs הן ברמת הפרויקט ב-Google Cloud.
מגבלת הקצב של ממשקי ה-API ל-Home היא 30,000 שאילתות לדקה (QPM) לכל פרויקט. המגבלה הזו כוללת את כל השאילתות שנשלחות דרך ממשקי ה-API של Home.
חריגה מהמכסה
כשיש חריגה מהגבלת הקצב של יצירת הבקשות ב-Home APIs, נזרקת השגיאה
resourceExhaused
HomeException. בקשות נוספות יידחו מיד ותופיע ההודעה "Quota exceeded".
אם חורגים מהמכסה, האפליקציות צריכות להציג השהיה מעריכית לפני ניסיון חוזר (exponential backoff) ולהודיע למשתמשים אם הפעולות מוגבלות באופן זמני.
מעקב
אתם יכולים להשתמש במסוף Google Cloud כדי לעקוב אחרי השימוש בזמן אמת ולהגדיר התראות יזומות כשאתם מתקרבים למכסה של Home APIs.
כדי לראות את המדדים הנוכחיים, עוברים לקטע מדדים של שירות 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.