ชุดทดสอบ Google Home

Cloud-to-cloud    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. ในช่องรหัสโปรเจ็กต์ ให้ป้อนตัวระบุโปรเจ็กต์สำหรับการดำเนินการสมาร์ทโฮม
    2. คลิกถัดไป

  4. กำหนดการตั้งค่าการทดสอบโดยทำดังนี้

    1. หากต้องการรับรองการดำเนินการสมาร์ทโฮมของคุณ ให้ปล่อยค่าสถานะรายงาน/ระยะหมดเวลาของการซิงค์คำขอที่เป็นค่าเริ่มต้นไว้ตามเดิม อย่างไรก็ตาม สำหรับการทดสอบ คุณสามารถเปลี่ยนค่าระยะหมดเวลาหาก Agent ต้องใช้เวลามากขึ้นในการรายงานสถานะไปยัง Home Graph

    2. หากคุณรับรองการดำเนินการสำหรับสมาร์ทโฮม โปรดตรวจสอบว่าได้เปิดใช้ตัวเลือกทดสอบการซิงค์คำขอแล้ว โดยในระหว่างการทดสอบ ระบบจะแจ้งให้คุณเพิ่ม อัปเดต หรือนำอุปกรณ์ออก และตรวจสอบว่ารายการอุปกรณ์มีการเปลี่ยนแปลงหรือไม่ใน Home Graph การเปลี่ยนแปลงจะเกิดขึ้นผ่านการผสานรวมที่คุณกำลังทดสอบ การผสานรวมระหว่างการทดสอบต้องมีอุปกรณ์อย่างน้อย 1 เครื่องแนบอยู่กับผู้ใช้ Agent เสมอ

    3. หากคุณใช้ลักษณะของ Scene ให้เลือกลักษณะโหมดทดสอบ

    4. หากคุณกำลังใช้ชุดทดสอบสำหรับอุปกรณ์ Local Home ให้เลือกรองรับ Local Home SDK

      1. เลือกการดำเนินการคำสั่งซื้อในพื้นที่หรือการตั้งค่าที่ราบรื่น
      2. คลิกรองรับการค้นหาในเครื่องหากอุปกรณ์สามารถจัดการ Intent ของ 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 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. กรอกข้อมูลในช่องที่ต้องกรอกทั้งหมด แล้วคลิกส่ง