Google Home टेस्ट सुइट

क्लाउड-टू-क्लाउड    Local Home SDK

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

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

Test Suite की मदद से ये टेस्ट किए जाते हैं. हालांकि, इनके अलावा और भी टेस्ट किए जा सकते हैं:

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

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

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 इंटिग्रेशन को सर्टिफ़ाइड कराना है, तो रिपोर्ट की स्थिति/रिपोर्ट सिंक करने का अनुरोध करने के लिए टाइम आउट की डिफ़ॉल्ट वैल्यू में कोई बदलाव न करें. हालांकि, अगर आपके एजेंट को होम ग्राफ़ में स्थिति की जानकारी भेजने में ज़्यादा समय लगता है, तो जांच के लिए टाइम आउट की वैल्यू बदली जा सकती है.
    2. Cloud-to-cloud इंटिग्रेशन को सर्टिफ़ाइड करते समय, पक्का करें कि सिंक करने के अनुरोध की जांच करें विकल्प चालू हो. जांच के दौरान, आपसे किसी डिवाइस को जोड़ने, अपडेट करने या हटाने के लिए कहा जाएगा. साथ ही, यह भी देखा जाएगा कि होम ग्राफ़ में डिवाइस की सूची में बदलाव हुआ है या नहीं. बदलाव करने की कार्रवाइयां, उस इंटिग्रेशन के ज़रिए होती हैं जिसकी जांच की जा रही है. टेस्ट किए जा रहे इंटिग्रेशन में, एजेंट उपयोगकर्ता से कम से कम एक डिवाइस जुड़ा होना चाहिए.

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

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

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

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

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

मॉड्यूल का डेटा पाने में गड़बड़ी: getModuleData गड़बड़ी: https://hometestsuiteproxy-pa.googleapis.com/v1/module:get के लिए, एचटीटीपी से जुड़ी गड़बड़ी का जवाब: 403 OK 403

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

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

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

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

  1. टेस्ट के नतीजे मिलने और Cloud-to-cloud इंटिग्रेशन को सर्टिफ़ाइड करने के लिए तैयार होने के बाद, Test Suite टूल में सबमिट करें पर क्लिक करें.
  2. टेस्ट के नतीजे देखने के लिए, टेस्ट के नतीजे डाउनलोड करें बटन पर क्लिक करें.
  3. Google को टेस्ट के नतीजे सबमिट करने के लिए, सबमिशन फ़ॉर्म पर जाएं पर क्लिक करें.
  4. सभी ज़रूरी फ़ील्ड भरें. इसके बाद, सबमिट करें पर क्लिक करें.