חבילת הבדיקה של Google Home

מענן לענן    Local Home SDK

Google Home Test Suite היא אפליקציית אינטרנט שמאפשרת לבדוק בעצמכם את הפעולה לבית החכם. ה-Test Suite יוצר ומריץ באופן אוטומטי תרחישי בדיקה על סמך המכשירים והמאפיינים שמשויכים לחשבון שלכם. כשמסיימים את הבדיקות, אפשר לראות את תוצאות הבדיקה.

כדי להשתמש ב-Test Suite ולשלוח את תוצאות הבדיקות ל-Google לצורך אישור, אפשר לעיין במידע שמופיע בדף בדיקה ושיתוף של פעולות לבית חכם. הגרסה הזו של Test Suite מיועדת במיוחד לפיתוח ולבקרת איכות.

הבדיקות שמבוצעות על ידי Test Suite כוללות, בין היתר:

• הבדיקה בודקת אם ההגדרות Report State ו-Request Sync מופעלות במכשירים ובמאפיינים שלכם.

• בדיקה שהכוונה QUERY מוטמעת במכשיר, והתוצאות שלה תואמות לתוצאות של 'סטטוס הדוח'.

אפשר להפעיל את הכלי Test Suite בלחיצה על הלחצן שבהמשך:

הפעלת Test Suite

בדיקה עצמית של הפעולה

בקטע הבא מוסבר איך להריץ את Test Suite במכשיר ובפרויקט הפעולה לבית חכם. כדי ש-Test Suite יוכל לבדוק את המכשירים ב-Google Home Graph ולשלוח פקודות ישירות ל-Google Assistant, צריך להיכנס לחשבון.

כדי לבדוק את הפעולה בעצמכם, עליכם לפעול לפי השלבים הבאים:

1. בדפדפן האינטרנט, פותחים את Test Suite.

2. נכנסים לחשבון Google באמצעות הלחצן בפינה השמאלית העליונה.

3. מגדירים את פרטי הפרויקט:

   1. בשדה Project ID, מזינים את מזהה הפרויקט של הפעולה לבית החכם.
   2. לוחצים על הבא.

4. מגדירים את הגדרות הבדיקה:

   1. אם אתם מאשרים את השילוב של Cloud-to-cloud, לא משנים את הערך שמוגדר כברירת מחדל בשדה Report State/Request Sync Timeout. עם זאת, לצורך בדיקה, אפשר לשנות את ערך הזמן הקצוב לתפוגה אם לסוכן נדרש יותר זמן לדווח על המצב ל-Home Graph.

   2. אם אתם מאשרים את השילוב של Cloud-to-cloud, ודאו שהאפשרות Test Request Sync מופעלת. במהלך הבדיקה, תתבקשו להוסיף, לעדכן או להסיר מכשיר ולבדוק אם רשימת המכשירים השתנתה ב-Home Graph. פעולות השינוי מתבצעות דרך השילוב שאתם בודקים. תמיד צריך לצרף מכשיר אחד לפחות למשתמש הנציג במסגרת השילוב שנמצא בבדיקה.

   3. אם משתמשים במאפיין Scene, בוחרים באפשרות מאפיין של סצנת בדיקה.

   4. אם מריצים את חבילת הבדיקה למכשירי Local Home, בוחרים באפשרות Supports Local Home SDK.

      1. בוחרים באפשרות מילוי הזמנות מקומי או הגדרה חלקה.
      2. לוחצים על Supports Local Query אם המכשיר יכול לטפל בכוונה QUERY באופן מקומי.

5. מבצעים הרצת בדיקה ומעיינים בתוצאות:

   1. לוחצים על הבא כדי להתחיל להריץ בדיקות. בממשק מוצגים המכשירים והמאפיינים שנבדקים.

6. נכנסים לדף תוצאות ושליחה:

   1. בסיום הבדיקות, לוחצים על הבא כדי להציג את התוצאות.

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

בדיקת אימות של קישור חשבון

קישור החשבון ממלא תפקיד חשוב בסביבה העסקית של 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.
בודקים אם אסימון הגישה לטווח קצר כולל טוקן רענון.	צריך לספק אסימון רענון כשאסימון הגישה פג תוקף. הבדיקה הזו תיכשל אם לא נמצא אסימון רענון.

בדיקת אימות של אסימון רענון

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

פריטים לבדיקה	הסבר
טוקן רענון עם טוקן רענון לא חוקי, בודקים את התשובה מהשותף.	השרת צריך להחזיר שגיאת HTTP 400 Bad Request עם הערך {"error": "invalid_grant"} לבקשה לא חוקית לאסימון רענון. אם התשובה לא תואמת ל'קוד השגיאה או להודעת השגיאה', תרחיש הבדיקה הזה יכשל. מידע נוסף זמין במאמר המרת אסימוני רענון לאסימוני גישה.
בדיקה אם אסימון הגישה עודכן אחרי רענון האסימון.	אסימוני גישה חדשים צריכים להוחזר בתגובה לבקשות לאסימוני רענון. אם השרת מספק את אותו אסימון גישה, תרחיש הבדיקה ייכשל.
בודקים אם אסימון הגישה שעדיין בתוקף עדיין תקף.	זמן התפוגה של אסימון הגישה יוצג.
בודקים אם אסימון הרענון בוצע במהלך הרענון.	אנחנו בודקים אם אסימוני הרענון השתנו אחרי בקשה לאסימון רענון. אם אסימון הרענון משתנה, השרת צריך לבטל את התוקף של אסימון הרענון הישן רק אחרי שהשתמשתם באסימון רענון חדש, כדי למנוע תנאי תחרות שעשויים לשבש את הקישור של חשבון המשתמש. הבדיקה תיכשל אם תבטלו את התוקף של אסימון הרענון הישן לפני שמשתמשים באסימון החדש.

הודעות שגיאה

בטבלה הבאה מפורטות כמה הודעות שגיאה נפוצות שאולי תיתקלו בהן, והצעות לפתרון הבעיות.

הודעת השגיאה	איך פותרים את הבעיה
לא נעשה שימוש ב-HomeGraph API בפרויקט <_id_> בעבר או שהוא מושבת	מוודאים שהפעלתם את HomeGraph API.
הישות המבוקשת לא נמצאה	בודקים שה-agentUserId תקין ומקושר לשירות.
חשוב לוודא שיש לכם הרשאת resourcemanager.projects.get בפרויקט ${your project id} ושנתתם את כל ההרשאות במסך ההסכמה. Error getting module data: getModuleData error: Http failure response for https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403	פועלים לפי ההוראות במאמר פתרון בעיות בהרשאות IAM כדי לוודא שלחשבון יש את ההרשאות resourcemanager.projects.get לפרויקט. עוברים לדף אפליקציות שיש להן גישה לחשבון כדי לבדוק את ההרשאות הבאות של 'חבילת בדיקות לבית חכם': פרטי חשבון בסיסיים הצגת כתובת האימייל הראשית של חשבון Google הצגת המידע האישי שלכם, כולל מידע אישי שהגדרתם כזמין לכולם הרשאת גישה נוספת שימוש ב-Assistant: גישה רחבה לחשבון Google שלכם בדיקת המכשירים לבית החכם ב-Home Graph ושליטה בהם אם מופיעה הודעת שגיאה לגבי הרשאה, צריך קודם להסיר את הגישה ולאשר את כל ההרשאות במסך ההסכמה כשנכנסים שוב.

שליחת תוצאות הבדיקה

כדי לשלוח את טופס ההסמכה, צריך לעבור 100% מהבדיקות ב-Test Suite. אם יש לכם מאפיינים שדורשים בדיקה ידנית, עדיין כדאי להפעיל את הכלי Test Suite ולצרף את התוצאה, גם אם היא לא עברה ב-100%.

כדי לשלוח את תוצאות הבדיקה ולאשר את השילוב של Cloud-to-cloud:

1. אחרי שמקבלים את תוצאות הבדיקה ומוכנים לאשר את השילוב של Cloud-to-cloud, לוחצים על Submit בכלי Test Suite.
2. לוחצים על הלחצן DOWNLOAD TEST RESULTS (הורדת תוצאות הבדיקה) כדי לאחזר את תוצאות הבדיקה.
3. לוחצים על GO TO SUBMISSION FORM (מעבר לטופס שליחה) כדי לשלוח את תוצאות הבדיקה אל Google.

4. ממלאים את כל שדות החובה ולוחצים על שליחה.