ชุดทดสอบ Google Home

Google Home Test Suite เป็นเว็บแอปพลิเคชันที่ช่วยให้คุณ ทดสอบด้วยตนเองสำหรับสมาร์ทโฮม Action Test Suite สร้างและเรียกใช้กรณีทดสอบโดยอัตโนมัติตามอุปกรณ์และลักษณะ ที่เชื่อมโยงกับบัญชีของคุณ เมื่อทำการทดสอบเสร็จแล้ว คุณจะดูผลการทดสอบได้

หากต้องการใช้ Test Suite และส่งผลการทดสอบให้ Google เพื่อรับการรับรอง โปรดดูข้อมูลในหน้าทดสอบและแชร์การกระทำในสมาร์ทโฮม Test Suite เวอร์ชันนี้มีไว้สําหรับการพัฒนาและการประกันคุณภาพโดยเฉพาะ

การทดสอบที่ Test Suite ดำเนินการรวมถึงแต่ไม่จำกัดเพียงรายการต่อไปนี้

  • ตรวจสอบว่าได้ใช้สถานะรายงานและ ซิงค์คำขอสำหรับอุปกรณ์และลักษณะของคุณแล้ว

  • ยืนยันว่ามีการใช้ Intent QUERY สำหรับอุปกรณ์และผลลัพธ์ตรงกับผลลัพธ์ของ Report State

คุณเปิดใช้เครื่องมือ Test Suite ได้โดยคลิกปุ่มด้านล่าง

เปิดตัว Test Suite

ทดสอบแอ็กชันด้วยตนเอง

ส่วนต่อไปนี้จะอธิบายวิธีเรียกใช้ Test Suite ใน อุปกรณ์และโปรเจ็กต์สมาร์ทโฮม Action ของคุณ Test Suite กำหนดให้คุณต้องลงชื่อเข้าใช้เพื่อให้ตรวจสอบอุปกรณ์ใน Google Home Graph และส่งคำสั่งไปยัง Google Assistant ได้โดยตรง

หากต้องการทดสอบแอ็กชันด้วยตนเอง ให้ทำตามขั้นตอนต่อไปนี้

  1. เปิด Test Suite ในเว็บเบราว์เซอร์

  2. ลงชื่อเข้าใช้ Google โดยใช้ปุ่มที่มุมขวาบน

  3. กำหนดค่ารายละเอียดโปรเจ็กต์

    1. ในช่องรหัสโปรเจ็กต์ ให้ป้อนตัวระบุโปรเจ็กต์สำหรับ สมาร์ทโฮม Action
    2. คลิกถัดไป

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

    1. หากรับรองการผสานรวม Cloud-to-cloud ให้ปล่อยค่าเริ่มต้นของสถานะรายงาน/คำขอหมดเวลาซิงค์ไว้ตามเดิม อย่างไรก็ตาม ในการทดสอบ คุณอาจเปลี่ยนค่าการหมดเวลาได้หากตัวแทนใช้เวลานานกว่าในการรายงานสถานะไปยัง Home Graph

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

หากต้องการส่งผลการทดสอบและรับรองCloud-to-cloud การผสานรวม ให้ทำตามขั้นตอนต่อไปนี้

  1. หลังจากได้รับผลการทดสอบและพร้อมที่จะรับรองการผสานรวม Cloud-to-cloud แล้ว ให้คลิกส่งในเครื่องมือ Test Suite
  2. ไปที่ Google Home Developer Console > Cloud-to-cloud > รับรอง
  3. เลือกการผสานรวมที่ต้องการรับรอง
  4. ในส่วนเอกสารประกอบ ให้ป้อน รหัสผลลัพธ์Test Suite

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