Google 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 ইন্টিগ্রেশন সার্টিফাই করালে, ডিফল্ট রিপোর্ট স্টেট/অনুরোধ সিঙ্ক করার টাইমআউট ভ্যালু অপরিবর্তিত রাখুন। তবে, পরীক্ষার জন্য, আপনার এজেন্ট যদি Home Graph-এ স্ট্যাটাস রিপোর্ট করতে বেশি সময় নেয়, তাহলে আপনি টাইমআউট ভ্যালু পরিবর্তন করতে পারেন।

   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.
মেয়াদ শেষ হয়ে যাওয়া অ্যাক্সেস টোকেনে রিফ্রেশ টোকেন আছে কিনা চেক করুন।	অ্যাক্সেস টোকেনের মেয়াদ শেষ হয়ে গেলে রিফ্রেশ টোকেন দিতে হবে। কোনও রিফ্রেশ টোকেন না পাওয়া গেলে এই পরীক্ষাটি ব্যর্থ হবে।

রিফ্রেশ টোকেন যাচাইকরণ টেস্ট

আপনার টোকেন এক্সচেঞ্জ এন্ডপয়েন্ট যাতে নতুন অ্যাক্সেস টোকেনের সাথে সঠিকভাবে সেগুলি এক্সচেঞ্জ করতে পারে তা নিশ্চিত করতে রিফ্রেশ টোকেন পরীক্ষা করা হয়।

টেস্ট আইটেম	ব্যাখ্যা
ভুল রিফ্রেশ টোকেন দিয়ে রিফ্রেশ টোকেন, পার্টনারের উত্তর চেক করা হচ্ছে।	আপনার সার্ভারকে ভুল রিফ্রেশ টোকেন অনুরোধের ক্ষেত্রে {"error": "invalid_grant"} সহ HTTP 400 ত্রুটিপূর্ণ অনুরোধ দেখাতে হবে। উত্তরে "এরর কোড বা মেসেজ" না থাকলে, এই টেস্ট কেস ফেল করবে। আরও তথ্যের জন্য অ্যাক্সেস টোকেনের জন্য রিফ্রেশ টোকেন এক্সচেঞ্জ করুন লিঙ্কে যান।
টোকেন রিফ্রেশ করার পরে অ্যাক্সেস টোকেন আপডেট করা হয়েছে কিনা তা পরীক্ষা করুন।	রিফ্রেশ টোকেন অনুরোধের উত্তরে নতুন অ্যাক্সেস টোকেন ফেরত দিতে হবে। আপনার সার্ভার একই অ্যাক্সেস টোকেন প্রদান করলে, টেস্ট কেসটি সফল হবে না।
মেয়াদ শেষ না হওয়া অ্যাক্সেস টোকেন এখনও বৈধ আছে কিনা তা চেক করুন।	অ্যাক্সেস টোকেনের মেয়াদ শেষ হওয়ার সময় দেখানো হবে।
রিফ্রেশ করার সময় রিফ্রেশ টোকেন রোটেট করা হয়েছে কিনা তা চেক করুন।	রিফ্রেশ টোকেনের অনুরোধের পরে রিফ্রেশ টোকেন পরিবর্তন করা হয়েছে কিনা তা আমরা চেক করি। রিফ্রেশ টোকেন পরিবর্তিত হলে, আপনার সার্ভারকে শুধুমাত্র একটি নতুন রিফ্রেশ টোকেন ব্যবহার করার পরে একটি পুরনো রিফ্রেশ টোকেন বাতিল করতে হবে, যাতে রেস কন্ডিশন প্রতিরোধ করা যায় যা ব্যবহারকারীর অ্যাকাউন্ট লিঙ্ক করা ভেঙে দিতে পারে। নতুন রিফ্রেশ টোকেন ব্যবহার করার আগে আপনি পুরনো রিফ্রেশ টোকেন বাতিল করে দিলে পরীক্ষাটি সফল হবে না।

সমস্যার মেসেজ

নিচে দেওয়া সারণীতে কিছু সাধারণ সমস্যার মেসেজ এবং সেগুলি সমাধান করার সাজেস্ট করা উপায় উল্লেখ করা হল।

ত্রুটি বার্তা	কীভাবে সমাধান করবেন
প্রোজেক্ট <_id_>-এ আগে HomeGraph API ব্যবহার করা হয়নি অথবা এটি বন্ধ করা আছে	HomeGraph API চালু করেছেন কিনা তা ভালো করে দেখে নিন।
অনুরোধ করা এন্টিটি খুঁজে পাওয়া যায়নি	আপনার agentUserId বৈধ এবং আপনার পরিষেবার সাথে লিঙ্ক করা আছে কিনা তা চেক করুন।
নিশ্চিত করুন যে আপনার ${your project id} প্রোজেক্টে resourcemanager.projects.get অনুমতি আছে এবং সম্মতি স্ক্রিনে সব অনুমতি মঞ্জুর করেছেন। মডিউল ডেটা পাওয়ার সময় সমস্যা হয়েছে: getModuleData error: Http failure response for https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403	আপনার অ্যাকাউন্টের resourcemanager.projects.get প্রোজেক্টের জন্য অনুমতি আছে কিনা তা নিশ্চিত করতে, IAM অনুমতি সংক্রান্ত সমস্যার সমাধান করুন লিঙ্কে দেওয়া নির্দেশাবলী অনুসরণ করুন। "স্মার্ট হোমের জন্য টেস্ট স্যুট" অ্যাপের জন্য নিম্নলিখিত অনুমতি চেক করতে আপনার অ্যাকাউন্টে অ্যাক্সেস আছে এমন অ্যাপ পেজে যান: অ্যাকাউন্টের প্রাথমিক তথ্য আপনার Google অ্যাকাউন্টের প্রাথমিক ইমেল আইডি দেখা আপনার ব্যক্তিগত তথ্য দেখুন, এর মধ্যে আপনি সর্বজনীনভাবে উপলভ্য করেছেন এমন যেকোনও ব্যক্তিগত তথ্য অন্তর্ভুক্ত অতিরিক্ত অ্যাক্সেস আপনার Assistant ব্যবহার করুন: আপনার Google অ্যাকাউন্টের সম্পূর্ণ অ্যাক্সেস পান আপনার হোম গ্রাফে স্মার্ট হোম ডিভাইস পরীক্ষা ও নিয়ন্ত্রণ করে অনুমতি সংক্রান্ত সমস্যা হলে, প্রথমে অ্যাক্সেস সরিয়ে দিন এবং আবার সাইন-ইন করার সময় সম্মতি স্ক্রিনে সব অনুমতি দিন।

টেস্টের ফলাফল জমা দিন

সার্টিফিকেশনের জন্য জমা দেওয়ার আগে আপনার 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. প্রয়োজনীয় সব ফিল্ড পূরণ করে জমা দিন বিকল্পে ক্লিক করুন।