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

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

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

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

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

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

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

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

הודעות שגיאה

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

הודעת שגיאה איך פותרים את הבעיה
לא נעשה שימוש ב-HomeGraph 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. כדי לוודא שלחשבון שלכם יש הרשאות resourcemanager.projects.get בפרויקט, עליכם לפעול לפי ההוראות במאמר פתרון בעיות בהרשאות IAM.
  2. נכנסים לדף אפליקציות עם גישה לחשבון כדי לבדוק את ההרשאות הבאות ל'חבילת בדיקה לבית חכם':
    • פרטי חשבון בסיסיים
      1. הצגת כתובת האימייל הראשית של חשבון Google
      2. הצגת המידע האישי שלך, כולל מידע אישי שהגדרת כך שיהיה גלוי לכולם
    • גישה נוספת
      1. שימוש בAssistant: גישה רחבה לחשבון Google שלך
      2. בדיקת המכשירים לבית החכם ושליטה בהם תרשים הבית
    אם מופיעה שגיאת הרשאה, קודם צריך להסיר את הרשאת הגישה ולתת את כל ההרשאות במסך ההסכמה בהתחברות הבאה.

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

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

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

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

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