مجموعه تست Google Home

Cloud-to-Cloud Local Home SDK

Google Home Test Suite یک برنامه تحت وب است که به شما امکان می‌دهد تا اقدام به خانه هوشمند خود را خودآزمایی کنید. Test Suite به طور خودکار موارد آزمایشی را بر اساس دستگاه‌ها و ویژگی‌های مرتبط با حساب شما ایجاد و اجرا می‌کند. پس از تکمیل تست ها، می توانید نتایج آزمون را مشاهده کنید.

برای استفاده از Test Suite و ارسال نتایج آزمایش‌های خود به Google برای تأیید، برای کسب اطلاعات به صفحه «تست و اشتراک‌گذاری اقدامات خانه هوشمند» مراجعه کنید. این نسخه از Test Suite به طور خاص برای توسعه و تضمین کیفیت است.

تست های اجرا شده توسط Test Suite شامل موارد زیر است، اما محدود به آنها نیست:

  • بررسی می‌کند که وضعیت گزارش و درخواست همگام‌سازی برای دستگاه‌ها و ویژگی‌های شما اجرا شده است.

  • تأیید می کند که هدف QUERY برای دستگاه شما اجرا شده است و نتایج آن با نتایج گزارش وضعیت مطابقت دارد.

با کلیک کردن روی دکمه زیر می‌توانید ابزار Test Suite را راه‌اندازی کنید:

Test Suite راه اندازی کنید

اقدام خود را خودآزمایی کنید

بخش زیر نحوه اجرای Test Suite را بر روی دستگاه و پروژه اکشن خانه هوشمند خود توضیح می دهد. Test Suite از شما می‌خواهد که وارد سیستم شوید تا بتواند دستگاه‌های موجود در Google Home Graph را بازرسی کند و دستورات را مستقیماً به Google Assistant ارسال کند.

برای خودآزمایی Action خود، این مراحل را دنبال کنید:

  1. در مرورگر وب خود، Test Suite را باز کنید.

  2. با استفاده از دکمه گوشه سمت راست بالا به Google وارد شوید.

  3. پیکربندی جزئیات پروژه :

    1. در قسمت Project ID ، شناسه پروژه برای اکشن خانه هوشمند خود را وارد کنید.
    2. روی Next کلیک کنید.

  4. پیکربندی تنظیمات تست :

    1. اگر ادغام Cloud-to-cloud خود را تأیید می‌کنید، مقدار پیش‌فرض گزارش وضعیت/ درخواست زمان‌بندی همگام‌سازی را بدون تغییر بگذارید. با این حال، برای آزمایش، اگر نماینده شما زمان بیشتری برای گزارش وضعیت به Home Graph صرف کند، می‌توانید مقدار وقفه را تغییر دهید.

    2. اگر ادغام Cloud-to-cloud خود را تأیید می‌کنید، مطمئن شوید که گزینه Test Request Sync فعال است—در طول آزمایش، از شما خواسته می‌شود دستگاهی را اضافه، به‌روزرسانی یا حذف کنید و بررسی کنید که آیا لیست دستگاه در Home Graph تغییر کرده است یا خیر. اقدامات تغییر از طریق ادغام مورد آزمایش شما انجام می شود. ادغام تحت آزمایش شما باید همیشه حداقل یک دستگاه متصل به کاربر عامل داشته باشد.

    3. اگر از یک ویژگی Scene استفاده می کنید، صفت صحنه آزمایشی را انتخاب کنید.

    4. اگر مجموعه آزمایشی را برای دستگاه‌های Local Home اجرا می‌کنید، گزینه Supports Local Home SDK را انتخاب کنید.

      1. Local Fulfillment یا Seamless Setup را انتخاب کنید.
      2. اگر دستگاه می تواند QUERY را به صورت محلی مدیریت کند، روی Supports Local Query کلیک کنید.

  5. اجرای آزمایشی و مشاهده نتایج:

    1. برای شروع اجرای تست ها روی Next کلیک کنید. رابط دستگاه ها و ویژگی هایی را که در حال آزمایش هستند نشان می دهد.

  6. مشاهده صفحه نتایج و ارسال :

    1. پس از اتمام تست ها روی Next کلیک کنید تا نتایج را مشاهده کنید.

نتایج آزمون شامل تعداد آزمون های گذرانده شده و رد شده و نمره نهایی که نشان دهنده درصد قبولی است.

تست اعتبار سنجی پیوند حساب

پیوند حساب ها نقش مهمی در اکوسیستم خانه هوشمند گوگل ایفا می کند. تست اعتبارسنجی پیوند حساب در 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.
بررسی کنید که نشانه دسترسی قابل انقضا دارای نشانه بازخوانی است. زمانی که نشانه دسترسی قابل انقضا باشد، باید یک نشانه به‌روزرسانی ارائه شود. اگر نشانه‌های تازه‌سازی پیدا نشود، این آزمایش ناموفق خواهد بود.

بازخوانی تست اعتبارسنجی رمز

توکن‌های Refresh برای اطمینان از اینکه نقطه پایانی تبادل توکن شما به درستی آنها را با توکن‌های دسترسی جدید مبادله می‌کند، آزمایش می‌شوند.

موارد تست توضیح
بازخوانی نشانه با نشانه بازخوانی نامعتبر، بررسی پاسخ شریک. سرور شما باید یک خطای 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. دستگاه های خانه هوشمند را در نمودار خانه خود بازرسی و کنترل کنید
    اگر با خطای مجوز مواجه شدید، ابتدا دسترسی را حذف کنید و پس از ورود مجدد به سیستم، همه مجوزها را در صفحه رضایت اعطا کنید.

نتایج آزمون را ارسال کنید

نتایج Test Suite شما باید 100٪ از آزمون‌ها را قبل از ارسال فرم گواهینامه خود بگذراند. اگر ویژگی‌هایی دارید که نیاز به آزمایش دستی دارد، همچنان باید ابزار Test Suite را اجرا کنید و نتیجه را پیوست کنید، حتی اگر 100% آن را تایید نکرده باشد.

برای ارسال نتایج آزمایش و تأیید ادغام Cloud-to-cloud خود، این مراحل را دنبال کنید:

  1. پس از اینکه نتایج آزمایش خود را دریافت کردید و آماده تأیید ادغام Cloud-to-cloud خود شدید، روی ارسال در ابزار Test Suite کلیک کنید.
  2. برای بازیابی نتایج آزمون، روی دکمه «دانلود نتایج آزمون» کلیک کنید.
  3. برای ارسال نتایج آزمون به Google، روی GO TO SubMISSION FORM کلیک کنید.

  4. تمام فیلدهای مورد نیاز را پر کنید، سپس روی ارسال کلیک کنید.