Google Home Test Suite היא אפליקציית אינטרנט שמאפשרת לכם לבדוק את הפעולה של הבית החכם שלכם. המערכת Test Suite יוצרת ומריצה באופן אוטומטי תרחישי בדיקה על סמך המכשירים והמאפיינים שמשויכים לחשבון שלכם. אחרי שתסיימו את הבדיקות, תוכלו לראות את התוצאות שלהן.
כדי להשתמש ב-Test Suite ולשלוח את תוצאות הבדיקות ל-Google לצורך אישור, אפשר לעיין במידע בדף בדיקה ושיתוף של פעולות לבית חכם. הגרסה הזו של Test Suite מיועדת במיוחד לפיתוח ולבקרת איכות.
הבדיקות שמבוצעות על ידי Test Suite כוללות, בין היתר, את הדברים הבאים:
בודקים שההגדרות Report State ו-Request Sync מופעלות במכשירים ובמאפיינים שלכם.
הפונקציה מאמתת שהכוונה QUERY מיושמת במכשיר, והתוצאות שלה תואמות לתוצאות של Report State.
אפשר להפעיל את הכלי Test Suite בלחיצה על הלחצן שלמטה:
בדיקה עצמית של הפעולה
בקטע הבא מוסבר איך להריץ את Test Suite במכשיר ובפרויקט הפעולה של הבית החכם. האפליקציה Test Suite מחייבת כניסה כדי שתוכל לבדוק מכשירים בGoogle Home Graph ולשלוח פקודות ישירות לGoogle Assistant.
כדי לבדוק את הפעולה בעצמכם, פועלים לפי השלבים הבאים:
- בדפדפן האינטרנט, פותחים את Test Suite.
לוחצים על הלחצן בפינה השמאלית העליונה כדי להיכנס לחשבון Google.
מגדירים את פרטי הפרויקט:
- בשדה Project ID (מזהה הפרויקט), מזינים את מזהה הפרויקט של הפעולה לבית חכם.
- לוחצים על הבא.
מגדירים את הגדרות הבדיקה:
- אם אתם מאשרים את השילוב של Cloud-to-cloud, אל תשנו את ערך ברירת המחדל של Report State/Request Sync Timeout. עם זאת, לצורך בדיקה, אפשר לשנות את ערך הזמן הקצוב לתפוגה אם לסוכן לוקח יותר זמן לדווח על מצב ל-Home Graph.
אם אתם מאשרים את השילוב של Cloud-to-cloud, ודאו שהאפשרות Test Request Sync (בדיקת סנכרון בקשות) מופעלת. במהלך הבדיקה, תתבקשו להוסיף, לעדכן או להסיר מכשיר ולבדוק אם רשימת המכשירים השתנתה ב-Home Graph. שינוי הפעולות מתבצע באמצעות השילוב שאתם בודקים. לפחות מכשיר אחד צריך להיות תמיד מחובר למשתמש הנציג בשילוב שנבדק.
אם אתם משתמשים בScene מאפיין, בוחרים באפשרות בדיקת מאפיין של סצנה.
אם אתם מריצים את חבילת הבדיקות למכשירי Local Home, בוחרים באפשרות Supports Local Home SDK (תמיכה ב-Local Home SDK).
- בוחרים באפשרות שילוח מקומי או הגדרה חלקה.
- לוחצים על Supports Local Query אם המכשיר יכול לטפל בכוונת QUERY באופן מקומי.
מבצעים הרצת בדיקה ומציגים את התוצאות:
- לוחצים על הבא כדי להתחיל להריץ בדיקות. בממשק מוצגים המכשירים והמאפיינים שנבדקים.
נכנסים לדף תוצאות ושליחה:
- אחרי שהבדיקות מסתיימות, לוחצים על הבא כדי לראות את התוצאות.
תוצאות הבדיקה כוללות את מספר הבדיקות שעברו ואת מספר הבדיקות שנכשלו, וגם ציון סופי שמציין את אחוז הבדיקות שעברו.
בדיקת אימות של קישור חשבון
קישור חשבונות ממלא תפקיד חשוב במערכת האקולוגית של הבית החכם של Google. בדיקת האימות של קישור החשבון ב-Test Suite בודקת את שירות ה-OAuth שלכם כדי לזהות בעיות פוטנציאליות.
בבדיקת האימות של קישור החשבונות יש בדיקות לאימות של אסימוני גישה ואסימוני רענון:
בדיקת אימות של טוקן גישה
אסימוני הגישה שמוחזרים מנקודת הקצה של המרת האסימון נבדקים כדי לוודא שהפורמט שלהם תקין ושהם מוחזרים עם אסימון רענון תקין.
| פריטי בדיקה | הסבר |
|---|---|
| בדיקה אם אסימון הגישה הוא בפורמט JWT | קישור לחשבון Google לא מומלץ לטוקנים של גישה בפורמט JWT. אם נמצא פורמט JWT, מוצגת האזהרה הבאה:
The access token seems to be JWT, this is not good. Because it
unnecessarily exposes information about partner implementation and we
recommend opaque symmetric encrypted access token.
|
| בודקים אם לטוקן גישה עם תפוגה יש טוקן רענון. | אם אפשר להגדיר תוקף לאסימון הגישה, צריך לספק אסימון רענון. הבדיקה הזו תיכשל אם לא יימצא אסימון רענון. |
בדיקת אימות של אסימון רענון
אסימוני רענון נבדקים כדי לוודא שנקודת הקצה (endpoint) של המרת האסימונים ממירה אותם לאסימוני גישה חדשים בצורה תקינה.
| פריטי בדיקה | הסבר |
|---|---|
| טוקן רענון עם טוקן רענון לא תקין, בדיקת התגובה של השותף. | השרת צריך להחזיר שגיאת בקשה שגויה מסוג HTTP 400 עם
{"error": "invalid_grant"} לבקשה לא חוקית של אסימון רענון.
אם התגובה לא תואמת ל'קוד השגיאה או ההודעה', מקרה הבדיקה הזה ייכשל. מידע נוסף זמין במאמר בנושא
המרת אסימוני רענון לאסימוני גישה. |
| בודקים אם אסימון הגישה עודכן אחרי רענון האסימון. | אסימוני גישה חדשים צריכים להיות מוחזרים בתגובה לבקשות של אסימוני רענון. אם השרת מספק את אותו אסימון גישה, תרחיש הבדיקה ייכשל. |
| בודקים אם אסימון הגישה שלא פג תוקפו עדיין תקף. | יוצג תאריך התפוגה של טוקן הגישה. |
| בודקים אם אסימון הרענון הוחלף במהלך הרענון. | אנחנו בודקים אם אסימוני הרענון משתנים אחרי בקשה לאסימון רענון. אם אסימון הרענון משתנה, השרת צריך לבטל את התוקף של אסימון רענון ישן רק אחרי שנעשה שימוש באסימון רענון חדש, כדי למנוע תנאי מירוץ שעלולים לשבש את קישור החשבון של המשתמש. הבדיקה תיכשל אם תבטלו את תוקף האסימון הישן לרענון לפני השימוש באסימון החדש. |
הודעות שגיאה
בטבלה הבאה מפורטות כמה הודעות שגיאה נפוצות שאולי תיתקלו בהן, ומוסבר מה צריך לעשות כדי לפתור את הבעיות שגרמו להצגתן.
| הודעת השגיאה | איך פותרים את הבעיה |
|---|---|
| לא נעשה שימוש ב-HomeGraph API בפרויקט <_id_> לפני כן או שהוא מושבת | מוודאים שהפעלתם את HomeGraph API. |
| היישות המבוקשת לא נמצאה | בודקים שמכשיר ה-agentUserId תקין ומקושר לשירות. |
חשוב לוודא שיש לכם הרשאה מסוג שגיאה בקבלת נתוני מודול: שגיאה ב-getModuleData: תגובת כשל ב-HTTP עבור https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403 |
|
שליחת תוצאות הבדיקה
כדי לשלוח את התוצאות לאישור, הן צריכות לעבור את כל הבדיקות.Test Suite אם יש לכם מאפיינים שדורשים בדיקה ידנית, עדיין כדאי להריץ את הכלי Test Suite ולצרף את התוצאה, גם אם היא לא עברה ב-100%.
כדי לשלוח את תוצאות הבדיקה ולאשר את השילוב של Cloud-to-cloud הפלטפורמה שלך, צריך לפעול לפי השלבים הבאים:
- אחרי שתקבלו את תוצאות הבדיקה ותהיו מוכנים לאשר את השילוב שלכם, תצטרכו ללחוץ על שליחה בכלי Test Suite.Cloud-to-cloud
- עוברים אל Google Home Developer Console > Cloud-to-cloud > אישור.
- בוחרים את השילוב שרוצים לאשר.
- בקטע Documentation (תיעוד), מזינים את Test Suiteמזהה התוצאות.
ממלאים את כל שדות החובה ולוחצים על שליחה.