হোম এপিআইগুলো কাঠামোর মধ্যে থাকা ডিভাইসগুলোতে অ্যাক্সেস দেওয়ার জন্য OAuth 2.0 ব্যবহার করে। OAuth একজন ব্যবহারকারীকে তার লগইন তথ্য প্রকাশ না করেই কোনো অ্যাপ বা পরিষেবাতে অনুমতি দেওয়ার সুযোগ দেয়।
আপনার কাছে যদি আগে থেকেই একটি যাচাইকৃত OAuth ক্লায়েন্ট থাকে (উদাহরণস্বরূপ, ইতিমধ্যে প্রকাশিত কোনো অ্যাপ থেকে), তাহলে আপনি নতুন কোনো ক্লায়েন্ট সেট আপ না করেই হোম এপিআইগুলো পরীক্ষা করার জন্য সেটি ব্যবহার করতে পারেন। আরও তথ্যের জন্য, “আপনার যদি একটি বিদ্যমান OAuth ক্লায়েন্ট থাকে” দেখুন।
অ্যাপটিতে সাইন করুন
প্রথমে, Android Studio আপনার অ্যাপটি চালিয়ে একটি ডিবাগ সার্টিফিকেট তৈরি করুন। আপনি যখন Android Studio কোনো অ্যাপ চালান বা ডিবাগ করেন, তখন এটি স্বয়ংক্রিয়ভাবে ডেভেলপমেন্ট এবং ডিবাগিংয়ের জন্য একটি ডিবাগ সার্টিফিকেট তৈরি করে। বিস্তারিত ব্যাখ্যার জন্য "অ্যান্ড্রয়েড স্টুডিও: আপনার ডিবাগ বিল্ড সাইন করুন" দেখুন।
অ্যাপটি চালু হয়ে গেলে:
আপনার মোবাইল ডিভাইসটি আপনার লোকাল মেশিনের সাথে সংযুক্ত করুন। Android Studio মডেল নম্বর অনুসারে আপনার সংযুক্ত ডিভাইসগুলোর তালিকা দেখাবে। তালিকা থেকে আপনার ডিভাইসটি নির্বাচন করুন, তারপর 'Run project'-এ ক্লিক করুন। এটি আপনার মোবাইল ডিভাইসে স্যাম্পল অ্যাপটি বিল্ড এবং ইনস্টল করবে।
আরও বিস্তারিত নির্দেশাবলীর জন্য, অ্যান্ড্রয়েড ডেভেলপার সাইটে ‘Run apps on a hardware device’ দেখুন।
চলমান অ্যাপটি বন্ধ করুন।
গুগল ক্লাউড কনসোল হেল্প সাইটে 'Setting up OAuth 2.0 / Native applications / Android' অংশে বিস্তারিত নির্দেশাবলী অনুসরণ করে ডিবাগ সার্টিফিকেটের SHA-1 ফিঙ্গারপ্রিন্টটি সংগ্রহ করুন।
OAuth সম্মতি স্ক্রিন সেট আপ করুন
- গুগল ক্লাউড কনসোলে, প্রজেক্ট সিলেক্টর ড্যাশবোর্ডে যান এবং যে প্রজেক্টটি আপনি OAuth ক্রেডেনশিয়াল তৈরি করতে ব্যবহার করতে চান, সেটি নির্বাচন করুন।
- API এবং পরিষেবা পৃষ্ঠায় যান এবং নেভিগেশন মেনুতে থাকা ক্রেডেনশিয়ালস- এ ক্লিক করুন।
আপনি যদি এই গুগল ক্লাউড প্রজেক্টের জন্য আপনার কনসেন্ট স্ক্রিনটি এখনও কনফিগার না করে থাকেন, তাহলে ‘কনসেন্ট স্ক্রিন কনফিগার করুন’ বাটনটি দেখা যাবে। সেক্ষেত্রে, নিচের পদ্ধতি অনুসরণ করে আপনার কনসেন্ট স্ক্রিনটি কনফিগার করুন। অন্যথায়, পরবর্তী বিভাগে চলে যান।
- ‘কনফিগার কনসেন্ট স্ক্রিন’- এ ক্লিক করুন। OAuth কনসেন্ট স্ক্রিন পেজটি প্রদর্শিত হবে।
- আপনার ব্যবহারের ধরনের ওপর নির্ভর করে Internal বা External নির্বাচন করুন, এবং তারপর Create-এ ক্লিক করুন। OAuth সম্মতি স্ক্রিন প্যানেটি প্রদর্শিত হবে।
- অ্যাপের তথ্য পাতায় পর্দায় দেওয়া নির্দেশনা অনুযায়ী তথ্য প্রবেশ করান এবং তারপর 'সংরক্ষণ করুন ও চালিয়ে যান' -এ ক্লিক করুন। স্কোপস পেইনটি প্রদর্শিত হবে।
- আপনাকে কোনো স্কোপ যোগ করতে হবে না, তাই সেভ অ্যান্ড কন্টিনিউ-তে ক্লিক করুন। টেস্ট ইউজার্স পেইনটি প্রদর্শিত হবে।
- Audience-এ ক্লিক করুন এবং + ADD USERS বোতামে ক্লিক করুন।
- আপনার টেস্ট ইউজারের ইমেল ঠিকানাটি প্রবেশ করান এবং সেভ (SAVE ) বাটনে ক্লিক করুন।
- সংরক্ষণ করুন এবং চালিয়ে যান- এ ক্লিক করুন। সারাংশ প্যানেলটি প্রদর্শিত হবে।
- আপনার OAuth সম্মতি স্ক্রিনের তথ্য পর্যালোচনা করুন, এবং তারপর 'ড্যাশবোর্ডে ফিরে যান' (Back to dashboard) এ ক্লিক করুন।
সম্পূর্ণ বিবরণের জন্য গুগল ক্লাউড কনসোল হেল্প সাইটে আপনার OAuth সম্মতি স্ক্রিন সেট আপ করা দেখুন।
অ্যাপটি নিবন্ধন করুন এবং পরিচয়পত্র তৈরি করুন।
OAuth 2.0-এর জন্য অ্যাপটি রেজিস্টার করতে এবং OAuth ক্রেডেনশিয়াল তৈরি করতে, “Setting up OAuth 2.0” -এ দেওয়া নির্দেশাবলী অনুসরণ করুন। আপনাকে অ্যাপের ধরন উল্লেখ করতে হবে, যা হলো নেটিভ/অ্যান্ড্রয়েড অ্যাপ ।
Google Cloud Console Help সাইটে "Setting up OAuth 2.0 / Native applications" এর নির্দেশাবলী অনুসরণ করে, অ্যাপটি সাইন করার মাধ্যমে প্রাপ্ত SHA-1 ফিঙ্গারপ্রিন্টটি Google Cloud কনসোলে সেট আপ করা OAuth ক্লায়েন্টে যোগ করুন।
আপনার মোবাইল ডিভাইসটি আপনার লোকাল মেশিনের সাথে সংযুক্ত করে, তালিকা থেকে আপনার ডিভাইসটি নির্বাচন করুন, তারপর এটি চালানোর জন্য আবার 'Run project'-এ ক্লিক করুন। আরও বিস্তারিত নির্দেশাবলীর জন্য, অ্যান্ড্রয়েড ডেভেলপারস সাইটে ' Run apps on a hardware device ' দেখুন।
আপনার যদি একটি বিদ্যমান OAuth ক্লায়েন্ট থাকে
আপনার প্রকাশিত অ্যাপের জন্য যদি আগে থেকেই একটি যাচাইকৃত OAuth ক্লায়েন্ট থাকে, তাহলে আপনি হোম এপিআইগুলো পরীক্ষা করার জন্য আপনার বিদ্যমান OAuth ক্লায়েন্টটি ব্যবহার করতে পারেন।
হোম এপিআই (Home API) পরীক্ষা ও ব্যবহার করার জন্য Google Home Developer Console রেজিস্ট্রেশনের প্রয়োজন নেই। তবে, আপনার অ্যাপটি প্রকাশ করার জন্য একটি অনুমোদিত Developer Console রেজিস্ট্রেশন প্রয়োজন হবে, এমনকি যদি আপনার কাছে অন্য কোনো ইন্টিগ্রেশন থেকে একটি যাচাইকৃত OAuth ক্লায়েন্ট থাকেও।
নিম্নলিখিত বিষয়গুলো প্রযোজ্য:
বিদ্যমান OAuth ক্লায়েন্ট ব্যবহার করার ক্ষেত্রে ব্যবহারকারীর সংখ্যা ১০০ জনে সীমাবদ্ধ। পরীক্ষামূলক ব্যবহারকারী যোগ করার বিষয়ে তথ্যের জন্য, দেখুনOAuth সম্মতি স্ক্রিনটি সেট আপ করুন ।OAuth যাচাইকরণ নির্বিশেষে, হোম এপিআই দ্বারা আরোপিত একটি সীমা রয়েছে যে ১০০ জন ব্যবহারকারী আপনার অ্যাপ্লিকেশনকে অনুমতি প্রদান করতে পারবেন। Developer Console নিবন্ধন সম্পন্ন হলে এই সীমাবদ্ধতা তুলে নেওয়া হয়।
Developer Console নিবন্ধন আপনার অ্যাপে হোম এপিআই (Home API) আপডেট করার প্রস্তুতি হিসেবে, যখন আপনি OAuth-এর মাধ্যমে ডিভাইস-টাইপ গ্রান্ট (device-type grants) সীমাবদ্ধ করতে প্রস্তুত হবেন, তখন এটি অনুমোদনের জন্য পাঠানো উচিত।
যেসব Google Cloud অ্যাপের OAuth ভেরিফিকেশন এখনও বাকি আছে, ভেরিফিকেশন সম্পন্ন না হওয়া পর্যন্ত ব্যবহারকারীরা OAuth ফ্লোটি সম্পূর্ণ করতে পারবেন না। অনুমতি দেওয়ার প্রচেষ্টা নিম্নলিখিত ত্রুটির সাথে ব্যর্থ হবে:
Access blocked: <Project Name> has not completed the Google verification process.