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

ענן לענן    Local Home SDK

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

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

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

  • מאשרת שה-Intent 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. אם מאשרים את הפעולה בבית החכם, משאירים את ערך ברירת המחדל Report State/Request Sync (הזמן הקצוב לתפוגה של בקשה לסנכרון) ללא שינוי. עם זאת, לצורך בדיקה, אפשר לשנות את ערך הזמן הקצוב לתפוגה אם לנציג נדרש יותר זמן לדווח על המצב ל-Home Graph.

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

    3. אם משתמשים במאפיין Scene, בוחרים באפשרות Test Scene trait.

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

      1. בוחרים באפשרות שירות מקומי או הגדרה חלקה.
      2. אם המכשיר יכול לטפל ב-Intent של QUERY באופן מקומי, לוחצים על Supports Local 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.
לאסימון הגישה שהתוקף שלו פג יש אסימון רענון. כשהתוקף של אסימון הגישה פג, יש לספק אסימון רענון. הבדיקה תיכשל אם לא יימצא אסימון רענון.

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

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

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

הודעות שגיאה

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

הודעת שגיאה איך פותרים את הבעיה
לא נעשה שימוש ב-Home Graph API בפרויקט <_id_> לפני כן או שהוא הושבת חשוב לוודא שהפעלתם את HomeGraph API.
היישות המבוקשת לא נמצאה צריך לוודא שהשדה agentUserId תקין ומקושר לשירות.

חשוב לוודא שיש לך הרשאת resourcemanager.projects.get בפרויקט ${your project id} ושניתנה כל ההרשאות במסך ההסכמה.

שגיאה בקבלת נתוני המודול: שגיאת getModuleData: תגובה של כשל Http עבור https://hometestSuiteproxy-pa.googleapis.com/v1/Module:get: 403 OK 403
  1. פועלים לפי ההוראות במאמר פתרון בעיות בהרשאות IAM כדי לוודא שלחשבון יש את ההרשאות resourcemanager.projects.get בפרויקט.
  2. אפשר להיכנס לדף אפליקציות שיש להן גישה לחשבון כדי לבדוק את ההרשאות הבאות ב'חבילת בדיקה לבית חכם':
    • פרטי חשבון בסיסיים
      1. הצגת כתובת האימייל הראשית של חשבון Google
      2. הצגת הפרטים האישיים שלך, כולל פרטים אישיים שבחרת לפרסם באופן גלוי לכולם
    • הרשאת גישה נוספת
      1. שימוש ב-Assistant: גישה רחבה לחשבון Google שלך
      2. בדיקת המכשירים לבית החכם ושליטה בהם ב-Home Graph
    אם מופיעה הודעת שגיאה לגבי ההרשאה, צריך קודם להסיר את הגישה ולהעניק את כל ההרשאות במסך ההסכמה לאחר ההתחברות מחדש.

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

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

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

  1. אחרי קבלת תוצאות הבדיקה, וכשמוכנים לאשר את הפעולה של הבית החכם, לוחצים על שליחה בכלי Test Suite.
  2. לוחצים על הלחצן הורדת תוצאות הבדיקה כדי לאחזר את תוצאות הבדיקה.
  3. כדי לשלוח את תוצאות הבדיקה אל Google, לוחצים על טופס ההרשמה.

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