গুগল হোম টেস্ট স্যুট

ক্লাউড-টু-ক্লাউড লোকাল হোম SDK

Google Home Test Suite হল একটি ওয়েব অ্যাপ্লিকেশন যা আপনাকে আপনার স্মার্ট হোম অ্যাকশনটি স্ব-পরীক্ষা করতে দেয়। Test Suite স্বয়ংক্রিয়ভাবে আপনার অ্যাকাউন্টের সাথে সম্পর্কিত ডিভাইস এবং বৈশিষ্ট্যের উপর ভিত্তি করে টেস্ট কেস তৈরি করে এবং চালায়। পরীক্ষাগুলি সম্পন্ন করার পরে, আপনি পরীক্ষার ফলাফল দেখতে পারবেন।

Test Suite ব্যবহার করতে এবং সার্টিফিকেশনের জন্য আপনার পরীক্ষার ফলাফল গুগলে জমা দিতে, তথ্যের জন্য টেস্ট অ্যান্ড শেয়ার স্মার্ট হোম অ্যাকশন পৃষ্ঠাটি দেখুন। 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. যদি আপনি লোকাল হোম ডিভাইসের জন্য টেস্ট স্যুটটি চালাচ্ছেন, তাহলে Supports Local Home SDK নির্বাচন করুন।

      1. স্থানীয় পূর্ণতা বা নিরবচ্ছিন্ন সেটআপ নির্বাচন করুন।
      2. যদি ডিভাইসটি স্থানীয়ভাবে QUERY ইনটেন্ট পরিচালনা করতে পারে তবে Supports Local Query এ ক্লিক করুন।

  5. একটি পরীক্ষা চালান এবং ফলাফল দেখুন:

    1. পরীক্ষা চালানো শুরু করতে পরবর্তী ক্লিক করুন। ইন্টারফেসটি পরীক্ষা করা হচ্ছে এমন ডিভাইস এবং বৈশিষ্ট্যগুলি দেখায়।

  6. ফলাফল এবং জমা দেওয়ার পৃষ্ঠাটি দেখুন:

    1. পরীক্ষা শেষ হয়ে গেলে, ফলাফল দেখতে পরবর্তী ক্লিক করুন।

পরীক্ষার ফলাফলের মধ্যে রয়েছে পাস এবং ফেলের সংখ্যা এবং পাসের শতাংশ নির্দেশ করে একটি চূড়ান্ত স্কোর।

অ্যাকাউন্ট লিঙ্কিং যাচাইকরণ পরীক্ষা

গুগল স্মার্ট হোম ইকোসিস্টেমে অ্যাকাউন্ট লিঙ্কিং একটি গুরুত্বপূর্ণ ভূমিকা পালন করে। Test Suite অ্যাকাউন্ট লিঙ্কিং যাচাইকরণ পরীক্ষা সম্ভাব্য সমস্যার জন্য আপনার OAuth পরিষেবা পরীক্ষা করে।

অ্যাকাউন্ট লিঙ্কিং যাচাইকরণ পরীক্ষায় অ্যাক্সেস টোকেন যাচাই এবং টোকেন রিফ্রেশ করার জন্য পরীক্ষা রয়েছে:

অ্যাক্সেস টোকেন যাচাইকরণ পরীক্ষা

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

পরীক্ষার আইটেম ব্যাখ্যা
অ্যাক্সেস টোকেন JWT ফর্ম্যাট কিনা তা পরীক্ষা করুন। গুগল অ্যাকাউন্ট লিঙ্কিং 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 সক্রিয় করেছেন।
অনুরোধকৃত সত্তা পাওয়া যায়নি আপনার agentUserId বৈধ কিনা এবং আপনার পরিষেবার সাথে লিঙ্ক করা আছে কিনা তা পরীক্ষা করুন।

নিশ্চিত করুন যে আপনার ${your project id} প্রজেক্টের জন্য resourcemanager.projects.get অনুমতি আছে এবং সম্মতি স্ক্রিনে সমস্ত অনুমতি মঞ্জুর করেছেন।

মডিউল ডেটা পেতে ত্রুটি: getModuleData ত্রুটি: https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 এর জন্য Http ব্যর্থতার প্রতিক্রিয়া ঠিক আছে 403

  1. আপনার অ্যাকাউন্টে resourcemanager.projects.get প্রকল্পের অনুমতি আছে কিনা তা নিশ্চিত করতে IAM অনুমতিগুলির সমস্যা সমাধানে নির্দেশাবলী অনুসরণ করুন।
  2. "টেস্ট স্যুট ফর স্মার্ট হোম" এর জন্য নিম্নলিখিত অনুমতিগুলি পরীক্ষা করতে আপনার অ্যাকাউন্ট পৃষ্ঠায় অ্যাক্সেস সহ অ্যাপগুলিতে যান:
    • অ্যাকাউন্টের প্রাথমিক তথ্য
      1. আপনার প্রাথমিক Google অ্যাকাউন্টের ইমেল ঠিকানা দেখুন
      2. আপনার ব্যক্তিগত তথ্য দেখুন, যার মধ্যে আপনার দ্বারা সর্বজনীনভাবে উপলব্ধ করা যেকোনো ব্যক্তিগত তথ্যও অন্তর্ভুক্ত।
    • অতিরিক্ত অ্যাক্সেস
      1. আপনার Assistant ব্যবহার করুন: আপনার Google অ্যাকাউন্টে বিস্তৃত অ্যাক্সেস
      2. আপনার হোম গ্রাফে স্মার্ট হোম ডিভাইসগুলি পরিদর্শন এবং নিয়ন্ত্রণ করুন
    যদি আপনার অনুমতি সংক্রান্ত কোনও ত্রুটি দেখা দেয়, তাহলে প্রথমে অ্যাক্সেস সরিয়ে ফেলুন এবং আবার সাইন ইন করার সময় সম্মতি স্ক্রিনে সমস্ত অনুমতি দিন।

পরীক্ষার ফলাফল জমা দিন

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