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

ענן לענן    Local Home SDK

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

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

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

  • מוודא שהכוונה QUERY מיושמת במכשיר ושהתוצאות שלו תואמות לתוצאות של מצב הדוח.

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

    3. אם אתם משתמשים בתכונה 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. ממלאים את כל שדות החובה ולוחצים על Submit.