Google Home टेस्ट सुइट

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

Test Suite का इस्तेमाल करने और सर्टिफ़िकेशन के लिए Google को टेस्ट के नतीजे सबमिट करने के बारे में जानकारी पाने के लिए, Test and share smart home Actions पेज देखें. Test Suite का यह वर्शन, खास तौर पर डेवलपमेंट और क्वालिटी अश्योरेंस के लिए है.

Test Suite से किए जाने वाले टेस्ट में ये शामिल हैं, लेकिन इन तक ही सीमित नहीं हैं:

• यह जांचना कि आपके डिवाइसों और सुविधाओं के लिए, Report State और Request Sync की प्रोसेस लागू की गई है या नहीं.

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

Test Suite टूल लॉन्च करने के लिए, नीचे दिए गए बटन पर क्लिक करें:

लॉन्च करें Test Suite

अपने ऐक्शन की खुद से जांच करना

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

अपने ऐक्शन की खुद से जांच करने के लिए, यह तरीका अपनाएं:

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

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

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

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

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

   1. अगर Cloud-to-cloud इंटिग्रेशन को सर्टिफ़ाई किया जा रहा है, तो डिफ़ॉल्ट Report State/Request Sync टाइम आउट की वैल्यू में कोई बदलाव न करें. हालांकि, टेस्टिंग के लिए, टाइम आउट की वैल्यू बदली जा सकती है. ऐसा तब किया जा सकता है, जब आपका एजेंट, Home Graph को स्टेट की रिपोर्ट करने में ज़्यादा समय लेता हो.

   2. अगर Cloud-to-cloud इंटिग्रेशन को सर्टिफ़ाई किया जा रहा है, तो पक्का करें कि Request Sync की जांच करें विकल्प चालू हो. टेस्टिंग के दौरान, आपसे कोई डिवाइस जोड़ने, अपडेट करने या हटाने के लिए कहा जाएगा. साथ ही, यह भी जांचने के लिए कहा जाएगा कि Home Graph में डिवाइस की सूची बदली है या नहीं. बदलाव करने की कार्रवाइयां, उस इंटिग्रेशन के ज़रिए होती हैं जिसकी टेस्टिंग की जा रही है. टेस्ट किए जा रहे इंटिग्रेशन में, एजेंट उपयोगकर्ता से कम से कम एक डिवाइस जुड़ा होना चाहिए.

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

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

      1. लोकल फ़ुलफ़िलमेंट या आसान सेटअप को चुनें.
      2. अगर डिवाइस, QUERY इंटेंट को स्थानीय तौर पर हैंडल कर सकता है, तो लोकल क्वेरी की सुविधा उपलब्ध है पर क्लिक करें.

5. टेस्ट चलाएं और नतीजे देखें:

   1. टेस्ट चलाने के लिए, आगे बढ़ें पर क्लिक करें. इंटरफ़ेस में, वे डिवाइस और सुविधाएं दिखती हैं जिनकी टेस्टिंग की जा रही है.

6. नतीजे और सबमिशन पेज देखें:

   1. टेस्ट पूरे होने के बाद, नतीजे देखने के लिए आगे बढ़ें पर क्लिक करें.

टेस्ट के नतीजों में, पास और फ़ेल हुए टेस्ट की संख्या और पास होने के प्रतिशत के बारे में बताने वाला फ़ाइनल स्कोर शामिल होता है.

खाता लिंक करने की पुष्टि करने वाला टेस्ट

Google के स्मार्ट होम इकोसिस्टम में, खाता लिंक करने की सुविधा अहम भूमिका निभाती है. Test SuiteTest 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"} भी लौटाना चाहिए. अगर जवाब, "गड़बड़ी कोड या मैसेज" से मैच नहीं होता है, तो यह टेस्ट केस फ़ेल हो जाएगा. ज़्यादा जानकारी के लिए, ऐक्सेस टोकन के लिए रीफ़्रेश टोकन एक्सचेंज करना लेख पढ़ें.
यह जांचना कि टोकन रीफ़्रेश होने के बाद, ऐक्सेस टोकन अपडेट हुआ है या नहीं.	रीफ़्रेश टोकन अनुरोधों के जवाब में, नए ऐक्सेस टोकन लौटाए जाने चाहिए. अगर आपका सर्वर, एक ही ऐक्सेस टोकन देता है, तो टेस्ट केस फ़ेल हो जाएगा.
यह जांचना कि समयसीमा खत्म न होने वाला ऐक्सेस टोकन अब भी मान्य है या नहीं.	ऐक्सेस टोकन की समयसीमा खत्म होने का समय दिखेगा.
यह जांचना कि रीफ़्रेश करते समय, रीफ़्रेश टोकन रोटेट हुआ है या नहीं.	हम यह जांचते हैं कि रीफ़्रेश टोकन के अनुरोध के बाद, रीफ़्रेश टोकन बदले जाते हैं या नहीं. अगर रीफ़्रेश टोकन बदलता है, तो आपके सर्वर को नया रीफ़्रेश टोकन इस्तेमाल होने के बाद ही, पुराना रीफ़्रेश टोकन अमान्य करना चाहिए. ऐसा इसलिए, ताकि रेस कंडीशन से बचा जा सके. रेस कंडीशन की वजह से, उपयोगकर्ता का खाता लिंक करने की प्रोसेस में गड़बड़ी हो सकती है. अगर नया रीफ़्रेश टोकन इस्तेमाल होने से पहले, पुराना रीफ़्रेश टोकन अमान्य कर दिया जाता है, तो टेस्ट फ़ेल हो जाएगा.

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

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

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

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

सर्टिफ़िकेशन के लिए सबमिट करने से पहले, आपके Test Suite के सभी टेस्ट में पास होना ज़रूरी है. अगर आपकी कुछ सुविधाओं के लिए, मैन्युअल तरीके से टेस्टिंग की ज़रूरत है, तो आपको Test Suite टूल चलाना चाहिए और नतीजे अटैच करने चाहिए. भले ही, सभी टेस्ट में पास न हुआ हो.

टेस्ट के नतीजे सबमिट करने और Cloud-to-cloud इंटिग्रेशन को सर्टिफ़ाई करने के लिए, यह तरीका अपनाएं:

1. टेस्ट के नतीजे मिलने के बाद, अगर आपको Cloud-to-cloud इंटिग्रेशन को सर्टिफ़ाई करना है, तो सबमिट करें Test Suite पर क्लिक करें.
2. Google Home Developer Console > Cloud-to-cloud > सर्टिफ़ाई करें पर जाएं.
3. वह इंटिग्रेशन चुनें जिसे आपको सर्टिफ़ाई करना है.
4. दस्तावेज़ में जाकर, अपने Test Suite नतीजों का आईडी डालें.

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