আপনার Android অ্যাপের জন্য OAuth সেট-আপ করা

Home API, স্ট্রাকচারে ডিভাইস অ্যাক্সেস করার অনুমতি দিতে OAuth 2.0 ব্যবহার করে। OAuth ব্যবহারকারীকে তার লগ-ইন ক্রেডেনশিয়াল প্রকাশ না করেই কোনও অ্যাপ বা পরিষেবাকে অনুমতি দেওয়ার সুযোগ দেয়।

আপনার কাছে আগে থেকেই যাচাই করা OAuth ক্লায়েন্ট থাকলে (যেমন, আগে থেকেই প্রকাশিত অ্যাপ থেকে), আপনি নতুন ক্লায়েন্ট সেট-আপ না করেই সেই ক্লায়েন্ট ব্যবহার করে Home API পরীক্ষা করতে পারবেন। আরও তথ্যের জন্য, আপনার কাছে আগে থেকেই OAuth ক্লায়েন্ট থাকলে দেখুন।

অ্যাপে সই করা

প্রথমে, আপনার অ্যাপটি Android Studio-এ রান করিয়ে একটি ডিবাগ সার্টিফিকেট তৈরি করুন। Android Studio-এ কোনও অ্যাপ রান বা ডিবাগ করলে, এটি অটোমেটিক ডেভেলপমেন্ট ও ডিবাগিংয়ের জন্য একটি ডিবাগ সার্টিফিকেট তৈরি করে। সম্পূর্ণ ব্যাখ্যা পেতে Android Studio: আপনার ডিবাগ বিল্ডে সই করুন লিঙ্ক দেখুন।

অ্যাপ চালু হয়ে গেলে:

1. আপনার মোবাইল ডিভাইস, লোকাল মেশিনের সাথে কানেক্ট করুন। Android Studio আপনার কানেক্ট করা ডিভাইসগুলিকে মডেল নম্বর অনুযায়ী তালিকাভুক্ত করবে। তালিকা থেকে আপনার ডিভাইস বেছে নিন, তারপর প্রোজেক্ট রান করুন বিকল্পে ক্লিক করুন। এটি আপনার মোবাইল ডিভাইসে Sample App তৈরি ও ইনস্টল করে।

   আরও বিস্তারিত নির্দেশাবলীর জন্য, Android Developers সাইটে হার্ডওয়্যার ডিভাইসে অ্যাপ রান করানো দেখুন।

2. চলমান অ্যাপ বন্ধ করুন।

3. Google Cloud Console সহায়তা সাইটে OAuth 2.0 / নেটিভ অ্যাপ্লিকেশন / Android লিঙ্কে বিস্তারিতভাবে দেওয়া নির্দেশাবলী অনুসরণ করে ডিবাগ সার্টিফিকেটের SHA-1 ফিঙ্গারপ্রিন্ট পান।

OAuth-এর সম্মতি সংক্রান্ত স্ক্রিন সেট-আপ করা

1. Google Cloud Console-এ, প্রোজেক্ট বাছাইকারী ড্যাশবোর্ডে যান এবং OAuth ক্রেডেনশিয়াল তৈরি করার জন্য যে প্রোজেক্ট ব্যবহার করতে চান সেটি বেছে নিন।
2. API ও পরিষেবা পৃষ্ঠায় যান এবং নেভিগেশন মেনুতে ক্রেডেনশিয়াল বিকল্পে ক্লিক করুন।

3. আপনি যদি এখনও এই Google Cloud প্রজেক্টের জন্য আপনার সম্মতি স্ক্রিন কনফিগার না করে থাকেন, তাহলে সম্মতি স্ক্রিন কনফিগার করুন বোতামটি দেখতে পাবেন। সেই ক্ষেত্রে, নিম্নলিখিত পদ্ধতি ব্যবহার করে আপনার সম্মতি স্ক্রিন কনফিগার করুন। অন্যথায়, পরবর্তী বিভাগে যান।

   1. সম্মতি স্ক্রিন কনফিগার করুন বিকল্পে ক্লিক করুন। OAuth-এর সম্মতি সংক্রান্ত স্ক্রিন পৃষ্ঠাটি দেখানো হয়।
   2. আপনার ব্যবহারের কেস অনুযায়ী, ইন্টার্নাল বা এক্সটার্নাল বিকল্প বেছে নিন এবং তারপর তৈরি করুন বিকল্পে ক্লিক করুন। OAuth-এর সম্মতি সংক্রান্ত স্ক্রিন প্যানেলটি দেখা যাবে।
   3. অন-স্ক্রিন নির্দেশাবলী অনুযায়ী অ্যাপ সংক্রান্ত তথ্য পৃষ্ঠায় তথ্য লিখুন এবং তারপরে সেভ করে চালিয়ে যান বিকল্পে ক্লিক করুন। স্কোপ প্যানেলটি দেখা যাবে।
   4. আপনাকে কোনও স্কোপ যোগ করতে হবে না, তাই সেভ করে চালিয়ে যান বিকল্পে ক্লিক করুন। টেস্ট ব্যবহারকারী প্যানেলটি দেখানো হয়।
   5. দর্শক বিকল্পে ক্লিক করে + ব্যবহারকারী যোগ করুন বোতামে ক্লিক করুন।
   6. আপনার টেস্ট ব্যবহারকারীর ইমেল আইডি লিখুন এবং সেভ করুন বোতামে ক্লিক করুন।
   7. সেভ করে চালিয়ে যান বিকল্পে ক্লিক করুন। সারসংক্ষেপ প্যানেলটি দেখা যাবে।
   8. আপনার OAuth-এর সম্মতি সংক্রান্ত স্ক্রিনের তথ্য পর্যালোচনা করুন এবং তারপরে ড্যাশবোর্ডে ফিরে যান বিকল্পে ক্লিক করুন।

সম্পূর্ণ বিবরণ পেতে, Google Cloud Console সহায়তা সাইটে আপনার OAuth-এর সম্মতি সংক্রান্ত স্ক্রিন সেট-আপ করা দেখুন।

অ্যাপ রেজিস্টার করা ও ক্রেডেনশিয়াল তৈরি করা

OAuth 2.0-এর জন্য অ্যাপ রেজিস্টার করতে এবং OAuth ক্রেডেনশিয়াল তৈরি করতে, OAuth 2.0 সেট-আপ করা লিঙ্কে দেওয়া নির্দেশাবলী অনুসরণ করুন। আপনাকে অ্যাপের ধরন উল্লেখ করতে হবে, যা হল নেটিভ/Android অ্যাপ।

Google Cloud Console সহায়তা সাইটে OAuth 2.0 / নেটিভ অ্যাপ্লিকেশন সেট-আপ করা লিঙ্কে দেওয়া নির্দেশাবলী অনুসরণ করে Google Cloud Console-এ সেট-আপ করা OAuth ক্লায়েন্টে অ্যাপে সই করার সময় পাওয়া SHA-1 ফিঙ্গারপ্রিন্ট যোগ করুন।

আপনার মোবাইল ডিভাইস লোকাল মেশিনের সাথে কানেক্ট করা থাকলে, তালিকা থেকে আপনার ডিভাইস বেছে নিন এবং সেটি চালানোর জন্য আবার প্রোজেক্ট চালান বিকল্পে ক্লিক করুন। আরও বিস্তারিত নির্দেশাবলীর জন্য, Android Developers সাইটে হার্ডওয়্যার ডিভাইসে অ্যাপ রান করানো দেখুন।

আপনার আগে থেকে কোনও OAuth ক্লায়েন্ট থাকলে

প্রকাশিত অ্যাপের জন্য আপনার আগে থেকেই যাচাই করা OAuth ক্লায়েন্ট থাকলে, আপনি Home API পরীক্ষা করার জন্য আগে থেকে থাকা OAuth ক্লায়েন্ট ব্যবহার করতে পারবেন।

Google Home Developer Console Home API পরীক্ষা ও ব্যবহার করার জন্য রেজিস্ট্রেশন করার প্রয়োজন নেই। তবে, অন্য ইন্টিগ্রেশন থেকে আপনার কাছে যাচাই করা Developer Console OAuth ক্লায়েন্ট থাকলেও, আপনার অ্যাপ প্রকাশ করার জন্য আপনাকে এখনও অনুমোদিত রেজিস্ট্রেশন করতে হবে।

নিম্নলিখিত বিষয়গুলি বিবেচনা করা হয়:

• আগে থেকেই রয়েছে এমন OAuth ক্লায়েন্ট ব্যবহার করার সময় ১০০ জন ব্যবহারকারীর সীমা থাকে। টেস্ট ব্যবহারকারী যোগ করা সংক্রান্ত তথ্যের জন্য,OAuth-এর সম্মতি সংক্রান্ত স্ক্রিন সেট-আপ করুন। OAuth যাচাইকরণ ছাড়াও, আপনার অ্যাপ্লিকেশনে অনুমতি দিতে পারেন এমন ১০০ জন ব্যবহারকারীর সীমা Home API-এর মাধ্যমে আরোপ করা হয়। Developer Console রেজিস্ট্রেশন সম্পূর্ণ হলে এই বিধিনিষেধ তুলে নেওয়া হয়।

• Developer Console রেজিস্ট্রেশন অনুমোদনের জন্য পাঠাতে হবে যখন আপনি Home API-এর মাধ্যমে আপনার অ্যাপ আপডেট করার প্রস্তুতি হিসেবে OAuth-এর মাধ্যমে ডিভাইস-টাইপ গ্র্যান্ট সীমাবদ্ধ করার জন্য প্রস্তুত হবেন।

যেসব Google Cloud অ্যাপের OAuth যাচাইকরণ এখনও বাকি আছে, সেগুলির ক্ষেত্রে যাচাইকরণ সম্পূর্ণ না হওয়া পর্যন্ত ব্যবহারকারীরা OAuth ফ্লো সম্পূর্ণ করতে পারবেন না। অনুমতি দেওয়ার চেষ্টা করলে নিম্নলিখিত সমস্যাটি হবে:

Access blocked: <Project Name> has not completed the Google verification process.