ชุดทดสอบ 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/Request Sync Timeout เริ่มต้นไว้ตามเดิม อย่างไรก็ตาม สำหรับการทดสอบ คุณสามารถเปลี่ยนค่าระยะหมดเวลาได้ หากตัวแทนใช้เวลามากกว่าในการให้สถานะรายงานไปยังกราฟหน้าแรก

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

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

    4. หากคุณใช้ชุดทดสอบสำหรับอุปกรณ์ Home 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"} ไปยังคำขอโทเค็นการรีเฟรชที่ไม่ถูกต้อง หากการตอบกลับไม่ตรงกับ "รหัสข้อผิดพลาดหรือข้อความแสดงข้อผิดพลาด" กรอบการทดสอบนี้จะล้มเหลว ดูข้อมูลเพิ่มเติมได้ที่ โทเค็นการรีเฟรชของ Exchange สำหรับโทเค็นเพื่อการเข้าถึง
ทดสอบว่าโทเค็นเพื่อการเข้าถึงได้รับการอัปเดตแล้วหรือไม่หลังจากรีเฟรชโทเค็น ควรแสดงผลโทเค็นเพื่อการเข้าถึงใหม่เพื่อตอบกลับคำขอโทเค็นการรีเฟรช หากเซิร์ฟเวอร์ให้โทเค็นเพื่อการเข้าถึงเดียวกัน กรอบการทดสอบจะล้มเหลว
ตรวจสอบว่าโทเค็นเพื่อการเข้าถึงที่ยังไม่หมดอายุยังคงใช้งานได้อยู่หรือไม่ เวลาหมดอายุของโทเค็นเพื่อการเข้าถึงจะแสดงขึ้น
ตรวจสอบว่าโทเค็นการรีเฟรชมีการหมุนเวียนในระหว่างการรีเฟรชหรือไม่ เราจะตรวจสอบว่าโทเค็นการรีเฟรชมีการเปลี่ยนแปลงหรือไม่หลังจากคำขอโทเค็นการรีเฟรช หากโทเค็นการรีเฟรชมีการเปลี่ยนแปลง เซิร์ฟเวอร์ของคุณควรทำให้โทเค็นการรีเฟรชเก่าใช้งานไม่ได้หลังจากใช้โทเค็นการรีเฟรชใหม่แล้วเท่านั้น เพื่อป้องกันเงื่อนไขในการแข่งขันอาจทำให้การลิงก์บัญชีของผู้ใช้เสียหาย การทดสอบจะล้มเหลวหากคุณยกเลิกโทเค็นการรีเฟรชเก่าก่อนที่จะใช้โทเค็นใหม่

ข้อความแสดงข้อผิดพลาด

ตารางต่อไปนี้แสดงข้อความแสดงข้อผิดพลาดที่พบบ่อยซึ่งคุณอาจพบ และวิธีแก้ไขที่แนะนำ

ข้อความแสดงข้อผิดพลาด วิธีแก้ไข
ไม่เคยใช้ 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% ก็ตาม

หากต้องการส่งผลการทดสอบและรับรองการดำเนินการของสมาร์ทโฮม ให้ทำตามขั้นตอนต่อไปนี้

  1. หลังจากได้รับผลการทดสอบและพร้อมที่จะรับรองการดำเนินการสำหรับสมาร์ทโฮมแล้ว ให้คลิกส่งในเครื่องมือ Test Suite
  2. คลิกปุ่มดาวน์โหลดผลการทดสอบเพื่อดูผลการทดสอบ
  3. คลิกไปที่แบบฟอร์มการส่งเพื่อส่งผลการทดสอบไปยัง Google

  4. กรอกข้อมูลในช่องที่ต้องกรอกทั้งหมด แล้วคลิกส่ง