Google Home टेस्ट सुइट

क्लाउड-टू-क्लाउड    लोकल होम SDK टूल

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

Test Suite की ओर से किए जाने वाले टेस्ट में, इनमें शामिल हैं, लेकिन इनमें और भी टेस्ट शामिल हैं:

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

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

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

Test Suite लॉन्च करें

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

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

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

1. अपने वेब ब्राउज़र में, Test Suite खोलें.

2. सबसे ऊपर दाएं कोने वाले बटन का इस्तेमाल करके, Google में साइन इन करें.

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

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

4. टेस्ट सेटिंग कॉन्फ़िगर करें:

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

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

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

   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.
समयसीमा खत्म होने वाले ऐक्सेस टोकन में रीफ़्रेश टोकन शामिल है.	ऐक्सेस टोकन की समयसीमा खत्म होने के बाद, रीफ़्रेश टोकन उपलब्ध कराना ज़रूरी है. रीफ़्रेश टोकन नहीं मिलने पर, यह जांच नहीं हो पाएगी.

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

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

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

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

यहां दी गई टेबल में, आम तौर पर होने वाली गड़बड़ियों के कुछ मैसेज और उन्हें ठीक करने का सुझाव दिया गया है.

गड़बड़ी संदेश	समस्या को हल करने का तरीका
HomeGraph API का इस्तेमाल <_id_> प्रोजेक्ट में पहले नहीं किया गया है या इसे बंद कर दिया गया है	पक्का करें कि आपने HomeGraph API चालू किया हो.
जिस इकाई के लिए अनुरोध किया गया है वह नहीं मिली	पक्का करें कि आपका agentUserId मान्य है और उसे आपकी सेवा से लिंक किया गया है.
पक्का करें कि आपके पास ${your project id} प्रोजेक्ट के लिए, resourcemanager.projects.get की अनुमति हो और आपने सहमति वाली स्क्रीन पर सभी अनुमतियां दी हों. मॉड्यूल डेटा पाने में गड़बड़ी हुई: getModuleData गड़बड़ी: https://hometestsuiteProxy-pa.googleapis.com/v1/module:get: 403 OK 403 के लिए Http विफल होने का जवाब	यह पक्का करने के लिए कि आपके खाते के पास प्रोजेक्ट के लिए, resourcemanager.projects.get अनुमतियां हैं, आईएएम अनुमतियों की समस्या हल करें पर दिए गए निर्देशों का पालन करें. "स्मार्ट होम के लिए टेस्ट सुइट" के लिए ये अनुमतियां देखने के लिए, आपके खाते के ऐक्सेस वाले ऐप्लिकेशन पेज पर जाएं: खाते की सामान्य जानकारी Google खाते का मुख्य ईमेल पता देखना सार्वजनिक की गई अपनी किसी भी निजी जानकारी के साथ-साथ अपनी निजी जानकारी देखें अन्य ऐक्सेस अपने Assistant का इस्तेमाल करें: आपके पास Google खाते का पूरा ऐक्सेस है अपने होम ग्राफ़ में मौजूद स्मार्ट होम डिवाइसों की जांच करें और उन्हें कंट्रोल करें अगर आपको अनुमति से जुड़ी कोई गड़बड़ी दिखती है, तो पहले ऐक्सेस हटाएं और फिर से लॉग इन करने पर सहमति वाली स्क्रीन में सभी अनुमतियां दें.

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

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

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

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

4. सभी ज़रूरी फ़ील्ड भरें. इसके बाद, सबमिट करें पर क्लिक करें.