ยินดีต้อนรับสู่ Google Home Developer Center แหล่งใหม่เรียนรู้วิธีพัฒนาการดําเนินการในบ้านอัจฉริยะ หมายเหตุ: คุณจะสร้างการดําเนินการต่างๆ ต่อไปในคอนโซลการดําเนินการ

ชุดทดสอบ Google Home

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

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

    3. หากคุณใช้ฟีเจอร์ฉาก ให้เลือกทดสอบโหมดฉาก

    4. หากใช้ชุดทดสอบสําหรับอุปกรณ์ Home ในเครื่อง ให้เลือกรองรับ SDK ของ Home ในพื้นที่

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

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

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

ข้อความแสดงข้อผิดพลาด วิธีแก้ไข
ไม่เคยใช้ HomeGraph API ในโปรเจ็กต์ <_id_> มาก่อนหรือปิดใช้อยู่ ตรวจสอบว่าคุณเปิดใช้ HomeGraph API แล้ว
ไม่พบเอนทิตีที่ขอ ตรวจสอบว่า agentUserId ถูกต้องและลิงก์กับบริการแล้ว
ตรวจสอบว่าคุณมีสิทธิ์ resourcemanager.projects.get ในโปรเจ็กต์ ${your project id} และได้ให้สิทธิ์ทั้งหมดในหน้าจอความยินยอม
  1. ทําตามวิธีการที่หัวข้อแก้ปัญหาสิทธิ์ IAM เพื่อให้แน่ใจว่าบัญชีมีสิทธิ์ resourcemanager.projects.get สําหรับโปรเจ็กต์
  2. ไปที่หน้าแอปที่มีสิทธิ์เข้าถึงบัญชีของคุณเพื่อตรวจสอบสิทธิ์ต่อไปนี้สําหรับ "ทดสอบชุดสมาร์ทโฮม"
    • ข้อมูลบัญชีทั่วไป
      1. ดูอีเมลหลักของบัญชี Google
      2. ดูข้อมูลส่วนตัว ซึ่งรวมถึงข้อมูลส่วนตัวใดๆ ที่คุณได้เผยแพร่ต่อสาธารณะด้วย
    • การเข้าถึงเพิ่มเติม
      1. ใช้ Assistant: การเข้าถึงบัญชี Google แบบกว้าง
      2. ตรวจสอบและควบคุมอุปกรณ์ในบ้านอัจฉริยะใน Home กราฟ
    หากใครหายไป ให้นําสิทธิ์เข้าถึงออกก่อน แล้วให้สิทธิ์ทั้งหมดในหน้าจอความยินยอมเมื่อเข้าสู่ระบบอีกครั้ง

ส่งผลการทดสอบ

ผล Test Suite ต้องผ่านการทดสอบ 100% ก่อนที่จะส่งแบบฟอร์มการรับรอง หากมีลักษณะใดๆ ที่ต้องมีการทดสอบด้วยตนเอง คุณควรเรียกใช้เครื่องมือ Test Suite แล้วแนบผลลัพธ์แม้ว่าจะไม่ผ่านทั้ง 100%

หากต้องการส่งผลการทดสอบและรับรองการดําเนินการในบ้านอัจฉริยะ ให้ทําตามขั้นตอนต่อไปนี้

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