מכסות ומגבלות לבית חכם

Google Home מגביל את הקצאת המשאבים והשימוש בהם, ומחיל מכסות מתאימות על בסיס כל פרויקט. מדיניות ספציפית משתנה בהתאם לזמינות המשאבים, לפרופיל המשתמש, להיסטוריית השימוש בשירות ולגורמים אחרים, והיא כפופה לשינויים ללא הודעה מוקדמת.

מגבלות על HomeGraph API

בקטע הזה מפורטות הגבלות הקצב של Google Home Graph API. המגבלות האלה חלות על REST וגם על RPC API.

Google מחילה את מגבלת ברירת המחדל של 6,000 בקשות ל-60 שניות על הצבירה של השאילתה, הסנכרון, המחיקה, Report State וקריאות ה-API של סנכרון בקשות אסינכרוניות, על בסיס כל שילוב Cloud-to-cloud.

כדי לבקש הגדלה של המכסה, צריך לפנות לכתובת ha-certification@google.com ולציין את הפרטים הבאים:

  • נושא האימייל: בקשה להגדלת המכסה של ReportState API
  • תוכן האימייל:
    • מזהה פרויקט
    • שם החברה שלך
    • המיכסה הנוכחית
    • הסיבה שביקשת להגדיל את המכסה
מכסה מגבלה אפשר להגדיל את המכסה
RequestSync (מצב סנכרוני) מקסימום בקשה אחת בו-זמנית לכל agentUserId. לא
RequestSync (asynchronous mode) מגבלת ברירת המחדל היא 6,000 בקשות לכל 60 שניות לכל שילוב של Cloud-to-cloud. כן
שאילתה מגבלת ברירת המחדל היא 6,000 בקשות לכל 60 שניות לכל שילוב של Cloud-to-cloud. כן
סנכרון מגבלת ברירת המחדל היא 6,000 בקשות לכל 60 שניות לכל שילוב של Cloud-to-cloud. כן
מחיקה מגבלת ברירת המחדל היא 6,000 בקשות לכל 60 שניות לכל שילוב של Cloud-to-cloud. כן
ReportStateAndNotification מגבלת ברירת המחדל היא 6,000 בקשות לכל 60 שניות לכל שילוב של Cloud-to-cloud. כן

ניפוי באגים בבעיות שקשורות למכסות

אם אתם נתקלים במגבלות קצב בשילוב, אתם יכולים להשתמש בהנחיות הבאות כדי לאבחן ולפתור בעיות שקשורות למכסת השימוש:

  1. ‫Google תגביל את קצב יצירת הבקשות ל-API אם תחרגו מהמכסה. הדבר משפיע לרעה על השילוב וגורם לאי-התאמות במצב. לדוגמה, אם בקשת ReportStateAndNotification נפסלת בגלל הגבלת קצב, הסנכרון של הסטטוס של המכשיר הפיזי ייכשל, ולכן ב-ReportStateAndNotification יוצג מידע לא עדכני.Google Home app (GHA)

  2. אם RequestSync הוא ה-API הראשי שנתקל בשגיאות, צריך לוודא שהשירות לא מנסה לבצע יותר מקריאה מקבילה אחת לכל agentUserId.

  3. בודקים את הצמיחה של נפח התנועה לאורך זמן. אם הגידול הזה עקבי עם עלייה במספר המכשירים, השקת סוג מכשיר חדש או השקה צפויה אחרת, כדאי לבקש הגדלת מכסה. אם העלייה הזו לא צפויה, כדאי לבדוק את השילוב כדי לראות אם שינוי לא צפוי גורם לשליחת יותר תנועה אל Home Graph API.