Google Home टेस्ट सुइट

Cloud-to-cloud    लोकल होम SDK टूल

Google Home Test Suite एक वेब ऐप्लिकेशन है. इससे अपने स्मार्ट होम ऐक्शन को खुद से टेस्ट किया जा सकता है. Test Suite आपके खाते से जुड़े डिवाइसों और विशेषताओं के आधार पर, टेस्ट केस अपने-आप जनरेट करता और चलाता है. जांच पूरी करने के बाद, Google पर जांच के नतीजे सबमिट करने के लिए, जांच के नतीजे देखे जा सकते हैं या सबमिशन फ़ॉर्म भरा जा सकता है.

Test Suite की ओर से किए गए टेस्ट में नीचे दिए गए टेस्ट शामिल हैं, लेकिन इन तक ही सीमित नहीं हैं:

  • यह जांच करता है कि आपके डिवाइसों और traits के लिए, रिपोर्ट की स्थिति और सिंक करने का अनुरोध लागू किया गया है या नहीं.

  • पुष्टि करता है कि QUERY इंटेंट, आपके डिवाइस के लिए लागू किया गया है और इसके नतीजे, रिपोर्ट की स्थिति के नतीजों से मेल खाते हैं.

नीचे दिए गए बटन पर क्लिक करके, Test Suite टूल लॉन्च किया जा सकता है:

Test Suite को लॉन्च करें

अपनी सेट की गई कार्रवाई को खुद टेस्ट करें

इस सेक्शन में, अपने डिवाइस और स्मार्ट होम ऐक्शन प्रोजेक्ट पर Test Suite चलाने का तरीका बताया गया है. Test Suite आपको साइन इन करना होगा, ताकि यह आपके Google Home Graph में मौजूद डिवाइसों की जांच कर सके और सीधे Google Assistant को निर्देश भेज सके.

अपनी सेट की गई कार्रवाई को खुद जांचने के लिए, यह तरीका अपनाएं:

  1. अपने वेब ब्राउज़र में, Test Suite खोलें.
  2. सबसे ऊपर दाएं कोने के बटन से Google में साइन इन करें.

  3. प्रोजेक्ट की जानकारी कॉन्फ़िगर करें:

    1. प्रोजेक्ट आईडी फ़ील्ड में, अपने स्मार्ट होम ऐक्शन के लिए प्रोजेक्ट आइडेंटिफ़ायर डालें.
    2. आगे बढ़ें पर क्लिक करें.
  4. टेस्ट सेटिंग को कॉन्फ़िगर करें:

    1. स्मार्ट होम ऐक्शन को प्रमाणित करते समय, रिपोर्ट की स्थिति/अनुरोध को सिंक करने के समय खत्म होने की डिफ़ॉल्ट वैल्यू में कोई बदलाव न करें. हालांकि, अगर आपके एजेंट को होम ग्राफ़ की स्थिति रिपोर्ट करने में ज़्यादा समय लगता है, तो टेस्टिंग के लिए टाइम आउट वैल्यू बदली जा सकती है.
    2. स्मार्ट होम ऐक्शन को प्रमाणित करते समय, पक्का करें कि टेस्ट के लिए अनुरोध सिंक करने का विकल्प चालू हो. टेस्टिंग के दौरान, आपको डिवाइस को जोड़ने, अपडेट करने या हटाने के लिए कहा जाएगा. साथ ही, यह देखने के लिए कहा जाएगा कि होम ग्राफ़ में डिवाइस की सूची बदली गई है या नहीं. जिस इंटिग्रेशन की जांच की जा रही है उसके ज़रिए बदलाव की कार्रवाइयां होती हैं. टेस्ट के तहत होने वाले आपके इंटिग्रेशन में, एजेंट उपयोगकर्ता से कम से कम एक डिवाइस हमेशा जुड़ा होना चाहिए.

    3. अगर Scene trait का इस्तेमाल किया जा रहा है, तो टेस्ट सीन trait चुनें.

    4. अगर लोकल होम डिवाइसों के लिए टेस्ट सुइट चलाया जा रहा है, तो लोकल होम SDK टूल के साथ काम करता है चुनें.

      1. स्थानीय तौर पर ऑर्डर पूरा करना या आसान सेटअप चुनें.
      2. अगर डिवाइस स्थानीय रूप से 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.
देखें कि एक्सपायर हो सकने वाले ऐक्सेस टोकन में रीफ़्रेश टोकन मौजूद है. ऐक्सेस टोकन की समयसीमा खत्म होने पर, रीफ़्रेश टोकन देना ज़रूरी है. रीफ़्रेश टोकन न मिलने पर, यह जांच नहीं हो पाएगी.

रीफ़्रेश टोकन की पुष्टि की जांच

रीफ़्रेश टोकन की जांच यह पक्का करने के लिए की जाती है कि आपका टोकन एक्सचेंज एंडपॉइंट उन्हें सही तरीके से नए ऐक्सेस टोकन के लिए बदलता है.

आइटम की जांच करें जानकारी
अमान्य रीफ़्रेश टोकन वाला रीफ़्रेश टोकन मौजूद है. इससे पार्टनर के जवाब की जांच की जा रही है. आपके सर्वर को अमान्य रीफ़्रेश टोकन अनुरोध पर {"error": "invalid_grant"} के साथ एचटीटीपी 400 खराब अनुरोध की गड़बड़ी दिखानी चाहिए. अगर जवाब "गड़बड़ी कोड या मैसेज" से मेल नहीं खाता, तो यह टेस्ट केस फ़ेल हो जाएगा. ज़्यादा जानकारी के लिए, ऐक्सेस टोकन के लिए एक्सचेंज रीफ़्रेश टोकन पर जाएं.
जांचें कि टोकन रीफ़्रेश करने के बाद, ऐक्सेस टोकन अपडेट किया गया है या नहीं. रीफ़्रेश टोकन के अनुरोध के जवाब में नए ऐक्सेस टोकन दिखाए जाने चाहिए. अगर आपका सर्वर वही ऐक्सेस टोकन देता है, तो टेस्ट केस काम नहीं करेगा.
देखें कि जिस ऐक्सेस टोकन की समयसीमा खत्म नहीं हुई है वह अब भी मान्य है या नहीं. आपको ऐक्सेस टोकन के खत्म होने की तारीख दिखेगी.
देखें कि रीफ़्रेश करते समय, रीफ़्रेश टोकन बदला गया है या नहीं. हम जांच करते हैं कि रीफ़्रेश टोकन अनुरोध के बाद रीफ़्रेश टोकन बदले गए हैं या नहीं. अगर रीफ़्रेश टोकन में बदलाव होता है, तो आपका सर्वर पुराने रीफ़्रेश टोकन को सिर्फ़ तब अमान्य करेगा, जब नया रीफ़्रेश टोकन इस्तेमाल किया गया हो. इससे, उन स्थितियों को रोका जा सकता है जिनकी वजह से उपयोगकर्ता का खाता लिंक करने में समस्या आ सकती है. अगर नए टोकन का इस्तेमाल करने से पहले पुराने रीफ़्रेश टोकन को अमान्य कर दिया जाता है, तो जांच नहीं हो पाएगी.

गड़बड़ी के मैसेज

नीचे दी गई टेबल में, गड़बड़ी के कुछ सामान्य मैसेज दिए गए हैं. साथ ही, उन्हें ठीक करने के लिए सुझाया गया तरीका भी बताया गया है.

गड़बड़ी संदेश समस्या हल करने का तरीका
HomeGraph API का इस्तेमाल <_id_> प्रोजेक्ट में पहले नहीं किया गया है या इसे बंद कर दिया गया है पक्का करें कि आपने HomeGraph API को चालू किया हो.
अनुरोध की गई इकाई नहीं मिली देख लें कि आपका agentUserId मान्य है और आपकी सेवा से जुड़ा हुआ है.

पक्का करें कि आपके पास ${your project id} प्रोजेक्ट के लिए, resourcemanager.projects.get अनुमति है. साथ ही, आपने सहमति वाली स्क्रीन में सभी अनुमतियां दी हैं.

मॉड्यूल डेटा पाने में गड़बड़ी हुई: getModuleData गड़बड़ी: https://hometestsuite टेक्सट प्रॉक्सी-pa.googleapis.com/v1/module:get: 403 OK 403 के लिए Http प्रोसेस पूरी नहीं हुई

  1. यह पक्का करने के लिए कि आपके खाते के पास प्रोजेक्ट के लिए resourcemanager.projects.get अनुमतियां हैं, IAM अनुमतियों से जुड़ी समस्या हल करें में दिए गए निर्देशों का पालन करें.
  2. "स्मार्ट होम के लिए टेस्ट सुइट" से जुड़ी ये अनुमतियां देखने के लिए, आपके खाते के ऐक्सेस वाले ऐप्लिकेशन पेज पर जाएं:
    • खाते की सामान्य जानकारी
      1. Google खाते का मुख्य ईमेल पता देखना
      2. अपनी निजी जानकारी देखें. इसमें वह निजी जानकारी भी शामिल है जो आपने सार्वजनिक तौर पर उपलब्ध कराई है
    • अतिरिक्त ऐक्सेस
      1. अपने Assistant का इस्तेमाल करें: अपने Google खाते का ब्रॉड ऐक्सेस
      2. अपने होम ग्राफ़ से जुड़े स्मार्ट होम डिवाइसों की जांच करें और उन्हें कंट्रोल करें
    अगर आपको अनुमति से जुड़ी गड़बड़ी का मैसेज मिलता है, तो पहले ऐक्सेस हटाएं. साथ ही, दोबारा लॉग इन करने पर सहमति वाली स्क्रीन में सभी अनुमतियां दें.

जांच के नतीजे सबमिट करें

सर्टिफ़िकेट का फ़ॉर्म सबमिट करने से पहले, यह ज़रूरी है कि आपके Test Suite के नतीजे 100% टेस्ट में पास हों. अगर आपके वीडियो में ऐसी विशेषताएं हैं जिन्हें मैन्युअल तौर पर टेस्ट करने की ज़रूरत है, तो आपको अब भी Test Suite टूल चलाना चाहिए. साथ ही, नतीजे को 100% पास न किए जाने पर भी अटैच कर देना चाहिए.

अपनी जांच के नतीजे सबमिट करने और अपने स्मार्ट होम ऐक्शन को प्रमाणित करने के लिए, यह तरीका अपनाएं:

  1. जांच के नतीजे मिलने और स्मार्ट होम ऐक्शन को प्रमाणित करने के लिए, Test Suite टूल में सबमिट करें पर क्लिक करें.
  2. अपने जांच के नतीजे फिर से पाने के लिए, टेस्ट के नतीजे डाउनलोड करें बटन पर क्लिक करें.
  3. Google को टेस्ट के नतीजे सबमिट करने के लिए, सबमिशन फ़ॉर्म पर जाएं पर क्लिक करें.
  4. सभी ज़रूरी फ़ील्ड भरें, फिर सबमिट करें पर क्लिक करें.