חבילת הבדיקה של 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. מגדירים את פרטי הפרויקט:

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

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

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

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

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

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

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

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

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