ชุดทดสอบ 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. หากต้องการรับรองการดำเนินการในสมาร์ทโฮม ให้ปล่อยค่า Report State Sync Timeout เริ่มต้นไว้ตามเดิม อย่างไรก็ตาม ในการทดสอบ คุณอาจเปลี่ยนค่าระยะหมดเวลาหากตัวแทนใช้เวลาในการรายงานสถานะไปยัง Home Graph นานกว่าปกติ

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

    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. กรอกข้อมูลในช่องที่ต้องกรอกทั้งหมด แล้วคลิกส่ง