Google Home מגביל את ההקצאה והשימוש במשאבים, ואוכף מכסות מתאימות לכל פרויקט. המדיניות הספציפית משתנה בהתאם לזמינות המשאבים, לפרופיל המשתמש, להיסטוריית השימוש בשירות ולגורמים אחרים, והיא כפופה לשינויים ללא הודעה מוקדמת.
מכסות בקשות API של HomeGraph
בקטע הזה מפורטות מגבלות הקצב של Google Home Graph API. המגבלות האלה חלות גם על ה-API ל-REST וגם על ה-API ל-RPC.
Google מחילה את המגבלה שמוגדרת כברירת מחדל של 6,000 בקשות לכל 60 שניות על סך כל הקריאות ל-API של שאילתות, סנכרון, מחיקה, Report State, וקריאות ל-API של בקשה לא סנכרונית, על בסיס כל Cloud-to-cloud.
כדי לבקש להגדיל את המכסה, צריך לשלוח אימייל לכתובת ha-certification@google.com ולציין את הפרטים הבאים:
- נושא האימייל: בקשה להגדלת המכסה של ReportState API
- תוכן האימייל:
- מזהה פרויקט
- שם החברה שלך
- המכסה הנוכחית
- הסיבה שבגללה אתם רוצים להגדיל את המכסה
| מכסה | מגבלה | אפשר להגדיל את המכסה |
|---|---|---|
| RequestSync (מצב סינכרוני) | מקסימום בקשה אחת בו-זמנית לכל agentUserId.
|
לא |
| RequestSync (מצב אסינכרוני) | מגבלת ברירת המחדל היא 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. | כן |
ניפוי באגים בבעיות שקשורות למכסות
אם השילוב שלכם נתקל בהגבלת קצב של יצירת בקשות, אתם יכולים להיעזר בהנחיות הבאות כדי לאבחן ולפתור בעיות שקשורות למכסות:
Google תגביל את קצב הקריאות ל-API שחורגות מהמכסה. זה משפיע לרעה על השילוב וגורם לחוסר התאמה במצבים. לדוגמה, אם בקשה של
ReportStateAndNotificationנדחית בגלל הגבלת קצב של יצירת בקשות, סטטוס המכשיר הפיזי לא יסונכרן, ו-Google Home app (GHA) יישאר עם מידע לא עדכני.אם
RequestSyncהוא ה-API הראשי שבו מתרחשות השגיאות, צריך לוודא שהשירות לא מנסה לבצע יותר מקריאה אחת בו-זמנית לכלagentUserId.בודקים את הגידול בתנועה לאורך זמן. אם הגידול הזה עקבי עם עלייה במספר המכשירים, השקה של סוג מכשיר חדש או השקה צפויה אחרת, צריך לבקש הגדלת מכסה. אם העלייה הזו לא צפויה, כדאי לבדוק את השילוב כדי לראות אם שינוי לא צפוי גורם לשליחת יותר תנועה ל-Home Graph API.