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

Cloud-to-cloud    Local Home SDK

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

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

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

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

• הבדיקה מוודאת שהכוונה QUERY מיושמת במכשיר, ושהתוצאות שלה תואמות לתוצאות של Report State.

כדי להפעיל את הכלי Test Suite, לוחצים על הכפתור הבא:

הפעלת Test Suite

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

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

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

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

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

3. מגדירים את Project Details:

   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, בחרו באפשרות Test Scene trait.

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

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

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

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

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

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

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

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

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

בדיקת האימות של קישור החשבונות כוללת בדיקות לאימות טוקני גישה וטוקני רענון:

בדיקת אימות של טוקן גישה

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

פריטי בדיקה	הסבר
איך בודקים אם טוקן הגישה הוא בפורמט JWT	לא מומלץ להשתמש בטוקני גישה בפורמט JWT כשמקשרים חשבון Google. אם נמצא פורמט 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 בפרויקט. עוברים לדף אפליקציות עם גישה לחשבון כדי לבדוק את ההרשאות הבאות של Test suite for smart home: פרטי חשבון בסיסיים לראות את כתובת האימייל בחשבון Google שלך לראות את הפרטים האישיים שלך, כולל פרטים שהגדרת כגלויים לכולם הרשאות גישה נוספות שימוש ב-Assistant: הרחבת הגישה לחשבון Google שלך בדיקת המכשירים לבית החכם ב-Home Graph ושליטה בהם אם מופיעה שגיאת הרשאה, קודם צריך להסיר את הגישה ואז לתת את כל ההרשאות במסך ההסכמה כשנכנסים שוב לחשבון.

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

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

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

1. אחרי שתקבלו את תוצאות הבדיקה ותהיו מוכנים לאשר את השילוב של Cloud-to-cloud, לחצו על Submit בכלי Test Suite.
2. עוברים אל Google Home Developer Console > Cloud-to-cloud > אישור.
3. בוחרים את השילוב שרוצים לאשר.
4. בקטע תיעוד, מזינים את מזהה התוצאות של Test Suite.

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