Device Access הפרויקטים מוגבלים על ידי מגבלות המשתמשים, המבנה וקצב השימוש, בהתאם לסביבה ולסוג של ההצעה המסחרית.
אנחנו רוצים שמפתחים ייצרו חוויות משתמש מעניינות, אבל רוצים גם השירות והמכשירים של Nest תמיד יהיו זמינים למשתמש. שילובים לבצע מספר גדול של בקשות בפרק זמן נתון יכולה להשפיע על השירות ועל זמינות המכשירים, כך ש-SDM API מחיל הגבלות קצב של יצירת בקשות. הגבלת הקצב של יצירת הבקשות מגבילה את מספר הקריאות ל-API בתקופת זמן נתונה, וגם מונעת שימוש יתר במשאבים.
מגבלות לפי סביבה
כל הפרויקטים מתחילים בסביבה Sandbox . ה-Sandbox הוא מיועד להערכת ממשק ה-API של SDM ולשימוש אישי, הן מוגבלות בהתאם. סביבות עם בסיס משתמשים גדול יותר, כמו על פיתוח מסחרי קיימות מגבלות שונות.
מגבלות משתמשים ב-Sandbox
חשבון פיתוח ב-Sandbox מוגבל ל-25 משתמשים מ-5 בכל הפרויקטים. אפשר ליצור עד 3 פרויקטים לכל חשבון.
המבנים מוגבלים ל-5 משתמשים לכל אחד, לכן הגעתם למגבלה של מספר המשתמשים בלבד ברגע שכל 5 המבנים יגיעו למכסה של 5 משתמשים בכל אחד. חשבון הפיתוח (שהפרויקט נמצא בבעלותו) לא נכלל בחישוב המגבלה של 5 משתמשים שלנו.
לעומת זאת, אם בפרויקט יש 15 משתמשים ב-5 מבנים, משתמשים נוספים יכולים ניתן להוסיף רק לחמישה המבנים הקיימים, כי מגבלת המבנה כבר הגעת.
מגבלות קצב של Sandbox
קצב הפריימים ב-Sandbox מוגבל ב-3 רמות שונות. המגבלות מוגדרות כך: של שאילתות לדקה (QPM), אלא אם צוין אחרת.
רמת ממשק API:
הקריאות ל-API מוגבלות לכל פרויקט למשתמש. לעיון ב-API הפניה לקבלת מידע נוסף על שיטות.
| שיטת ה-API | מגבלת הקצב של יצירת הבקשות |
|---|---|
devices.executeCommand |
10 QPM |
devices.get |
10 QPM |
devices.list |
5 QPM |
structures.get |
5 QPM |
structures.list |
5 QPM |
structures.rooms.get |
5 QPM |
structures.rooms.list |
5 QPM |
רמת הפקודה
כל פקודת trait (devices.executeCommand) מוגבלת ל-5 QPM לכל פרויקט,
למשתמש, לכל מכשיר.
כלומר, אם בפרויקט יש 2 משתמשים עם 2 מכשירים לכל אחד (4 מכשירים בסך הכול), אפשר לקרוא לאותה פקודה 5 פעמים בדקה לכל אחד מ-4 המכשירים האלה.
עם זאת, אם בפרויקט יש 2 משתמשים עם 3 מכשירים לכל אחד ב-6 מכשירים בסך הכול,
לא ניתן לקרוא לאותה פקודה 5 פעמים בדקה עבור כל אחת מ-6 הפקודה
מכשירים. התוצאה תהיה 15 QPM לכל משתמש, כאשר
מגבלת הקצב של devices.executeCommand רמת ה-API למשתמשים בפרויקט היא 10 QPM.
רמת המופע של המכשיר
בנוסף, מגבלות ברמת המופע של המכשיר מיושמות בפרויקטים שונים,
פקודות (devices.executeCommand) להגנה על הסוללה של המכשיר. המגבלות האלה
מוחלות גם ברמת ה-QPM וגם ברמת השאילתות לשעה (QPH) ולא חלות
ל-methods של ה-API get ו-list.
לדוגמה, נניח שלפרויקט א' ולפרויקט ב' יש גישה לאותה המכשיר, מכשיר א' (אולי המשתמש אישר שתי פרסומות שילובים שמשתמשים באותו מכשיר). אם נשלחו מ-Project A 4 פקודות מכשיר א' בתוך דקה, ואז פרויקט ב' יכול לשלוח רק פקודה אחת למכשיר א' אותה דקה לפני הגעה למגבלת הקצב של מהירות המופע במכשיר. אז נקודה, פקודות משני הפרויקטים אל מכשיר א' מווסתות עד לסוף הדקה שהתחילה בפקודה הראשונה במכשיר א.
אם סוג המכשיר לא מופיע ברשימה למטה, אין לו רמת מופע של המכשיר. הגבלות שער.
| סוג מכשיר | מגבלת קצב של מספר המכונות במכשיר |
|---|---|
| תרמוסטט | 5 QPM או 100 QPH |
| מצלמה | 30 QPM או 100 QPH |
| DOORBELL | 30 QPM או 100 QPH |
שגיאות
קודי השגיאה הבאים עשויים להיות מוחזרים בהקשר למדריך הזה:
| הודעת שגיאה | הכנסה לקליק | פתרון בעיות |
|---|---|---|
| דירוג מוגבל. | RESOURCE_EXHAUSTED |
לכל מפתח יש מכסה שמגבילה את מספר השיחות שהוא יכול לבצע. אם תבצעו יותר שיחות מהמכסה שלכם, תקבלו את ההודעה 'הגבלת הקצב של יצירת בקשות'. כדי לפתור את הבעיה, תצטרכו לשלוח מחדש את הקריאה אחרי שהמכסה תסתיים. |
מידע נוסף זמין בחומר העזר בנושא קוד שגיאה של API את הרשימה המלאה של קודי השגיאה של ה-API.