সাইন-আপ ও API কী

অননুমোদিত হওয়ার বিজ্ঞপ্তি: Awareness API অননুমোদিত হয়ে গেছে।

সতর্কতা: Awareness API অননুমোদিত হয়ে গেছে।

• Google Play পরিষেবা ভবিষ্যতে রিলিজ করা ভার্সনে Awareness API-এর জন্য সহায়তা বন্ধ করে দেবে, ২০২৭ সালের জানুয়ারি মাস থেকেই এটি হতে পারে।
• সরাসরি কোনও বিকল্প নেই।

Google Awareness API ব্যবহার করতে হলে, আপনার অ্যাপে Google API key যোগ করতে হবে। আপনার যে ধরনের API key প্রয়োজন তা হল Android API key.

সব Android অ্যাপ ডিজিটাল সার্টিফিকেটের মাধ্যমে সাইন করা হয় যার জন্য আপনার কাছে ব্যক্তিগত কী থাকে। ডিজিটাল সার্টিফিকেট সম্পর্কে আরও তথ্য পেতে, কীভাবে আপনার অ্যাপে সই করবেন সেই বিষয়ে Android নির্দেশিকা দেখুন।

Android API কী নির্দিষ্ট সার্টিফিকেট-প্যাকেজ পেয়ারের সাথে লিঙ্ক করা থাকে। আপনার অ্যাপে যতজন ব্যবহারকারীই থাকুন না কেন, প্রতিটি সার্টিফিকেটের জন্য আপনাকে শুধুমাত্র একটি কী ব্যবহার করতে হবে।

আপনার অ্যাপের জন্য কী পেতে আপনাকে বেশ কয়েকটি ধাপ অনুসরণ করতে হবে। এই নির্দেশিকায় সেগুলি বিস্তারিতভাবে বর্ণনা করা হয়েছে এবং নিচে সংক্ষিপ্তভাবে দেওয়া হল:

1. আপনার অ্যাপের সার্টিফিকেট সম্পর্কে তথ্য পান।
2. Google Developers কনসোলে একটি প্রোজেক্ট রেজিস্টার করুন এবং প্রোজেক্টের জন্য পরিষেবা হিসেবে User Context API যোগ করুন।
3. কী-এর জন্য অনুরোধ করুন।
4. আপনার অ্যাপে কী যোগ করুন। এটি করতে, আপনার অ্যাপ মেনিফেস্টে একটি এলিমেন্ট যোগ করুন।

আপনার অ্যাপের সার্টিফিকেট সংক্রান্ত তথ্য খুঁজে দেখা

API কী আপনার অ্যাপের ডিজিটাল সার্টিফিকেটের সংক্ষিপ্ত ফর্মের উপর ভিত্তি করে তৈরি হয়, যা SHA-1 ফিঙ্গারপ্রিন্ট নামে পরিচিত। আপনার সার্টিফিকেটের SHA-1 ফিঙ্গারপ্রিন্ট দেখাতে, প্রথমে নিশ্চিত করুন যে আপনি সঠিক সার্টিফিকেট ব্যবহার করছেন। আপনার কাছে বেছে নেওয়ার জন্য নিম্নলিখিত দুটি সার্টিফিকেট থাকতে পারে:

• একটি ডিবাগ সার্টিফিকেট: আপনি ডিবাগ বিল্ড করলে Android SDK টুল এই সার্টিফিকেট অটোমেটিক তৈরি করে। আপনি যেসব অ্যাপ পরীক্ষা করছেন, শুধুমাত্র সেগুলির সাথেই এই সার্টিফিকেট ব্যবহার করুন। ডিবাগ সার্টিফিকেট দিয়ে সাইন-ইন করা অ্যাপ প্রকাশ করার চেষ্টা করবেন না। Android ডেভেলপার ডকুমেন্টেশনের আপনার ডিবাগ বিল্ড স্বাক্ষর করুন বিভাগে ডিবাগ সার্টিফিকেট সম্পর্কে আরও বিস্তারিত বিবরণ দেওয়া আছে।
• রিলিজ সার্টিফিকেট: আপনি রিলিজ বিল্ড করলে Android SDK টুল এই সার্টিফিকেট তৈরি করে। এছাড়াও, আপনি keytool প্রোগ্রামের মাধ্যমে এই সার্টিফিকেট তৈরি করতে পারবেন। আপনার অ্যাপ সারা বিশ্বের জন্য রিলিজ করার জন্য প্রস্তুত হলে এই সার্টিফিকেট ব্যবহার করুন।

keytool সম্পর্কে আরও তথ্য পেতে, এর Oracle ডকুমেন্টেশন দেখুন।

ডিবাগ সার্টিফিকেট

ডিবাগ সার্টিফিকেট ফিঙ্গারপ্রিন্ট দেখানো

সার্টিফিকেটের SHA-1 ফিঙ্গারপ্রিন্ট দেখতে -v প্যারামিটার সহ keytool প্রোগ্রাম ব্যবহার করুন। এটি করতে, নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

1. আপনার ডিবাগ কীস্টোর ফাইল খুঁজে নিন। ফাইলের নাম হল debug.keystore এবং আপনি প্রথমবার নিজের প্রোজেক্ট তৈরি করার সময় এটি তৈরি হয়। ডিফল্ট হিসেবে, এটি আপনার Android ভার্চুয়াল ডিভাইস (AVD) ফাইলের মতো একই ডিরেক্টরিতে স্টোর করা হয়:

   • OS X এবং Linux: ~/.android/
   • Windows Vista ও Windows 7: C:\Users\your_user_name\.android\

2. SHA-1 ফিঙ্গারপ্রিন্টের তালিকা তৈরি করুন:

   • Linux বা OS X-এর জন্য, একটি টার্মিনাল উইন্ডো খুলুন এবং নিম্নলিখিত কমান্ডটি লিখুন:

     keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android

   • Windows Vista এবং Windows 7-এর জন্য, নিম্নলিখিত কমান্ড চালান:

     keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

আপনি নিম্নলিখিত আউটপুটের মতো আউটপুট দেখতে পাবেন:

Alias name: androiddebugkey
Creation date: Jan 01, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
     MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9
     SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75
     Signature algorithm name: SHA1withRSA
     Version: 3

রিলিজ সার্টিফিকেট

রিলিজ সার্টিফিকেটের ফিঙ্গারপ্রিন্ট দেখানো

সার্টিফিকেটের SHA-1 ফিঙ্গারপ্রিন্ট দেখাতে -v প্যারামিটার সহ keytool প্রোগ্রাম ব্যবহার করুন। এটি করতে, নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

1. আপনার রিলিজ সার্টিফিকেট কীস্টোর ফাইলটি খুঁজে নিন। রিলিজ কীস্টোরের কোনও ডিফল্ট লোকেশন বা নাম নেই। রিলিজ করার জন্য অ্যাপ তৈরি করার সময় আপনি কোনও কী উল্লেখ না করলে, বিল্ডটি আপনার অ্যাপকে .apk স্বাক্ষরবিহীন রেখে দেয় এবং প্রকাশ করার আগে আপনাকে সেটি স্বাক্ষর করতে হবে। রিলিজ সার্টিফিকেটের জন্য, আপনাকে সার্টিফিকেটের অ্যালিয়াস, কীস্টোরের পাসওয়ার্ড এবং সার্টিফিকেটও দিতে হবে।

2. কীস্টোরে থাকা সব কীয়ের জন্য অ্যালিয়াস তালিকাভুক্ত করতে, নিম্নলিখিত কমান্ড লিখুন:

   keytool -list -keystore your_keystore_name
         

3. your_keystore_name-এর জায়গায় কীস্টোরের সম্পূর্ণ কোয়ালিফায়েড পাথ ও নাম লিখুন। .keystore এক্সটেনশন অন্তর্ভুক্ত করুন। প্রম্পট করা হলে, কীস্টোরের পাসওয়ার্ড লিখুন। তারপর, keytool কীস্টোরে সব ছদ্মনাম দেখায়।

4. টার্মিনাল বা কমান্ড প্রম্পটে নিম্নলিখিতগুলি লিখুন:

         keytool -list -v -keystore your_keystore_name -alias your_alias_name
         

5. your_keystore_name-এর জায়গায় কীস্টোরের সম্পূর্ণ উপযুক্ত পাথ ও নাম লিখুন। .keystore এক্সটেনশন অন্তর্ভুক্ত করুন।
6. your_alias_name-এর পরিবর্তে, আপনি সার্টিফিকেট তৈরি করার সময় সেটিতে যে ছদ্মনাম অ্যাসাইন করেছিলেন সেটি লিখুন।

আপনি নিম্নলিখিত আউটপুটের মতো আউটপুট দেখতে পাবেন:

Alias name: <alias_name>
Creation date: Feb 02, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4cc9b300
Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

SHA1 দিয়ে শুরু হওয়া লাইনে সার্টিফিকেটের SHA-1 ফিঙ্গারপ্রিন্ট আছে। ফিঙ্গারপ্রিন্ট হল কোলন দিয়ে আলাদা করা ২০টি দুই-অঙ্কের হেক্সাডেসিমেল সংখ্যার ক্রম।

সতর্কতা: আপনার কীস্টোর ও কী সুরক্ষিত রাখতে, আপনার কম্পিউটারের নিরাপত্তা সম্পর্কে নিশ্চিত না হলে কমান্ড লাইনে storepass বা keypass আর্গুমেন্ট লিখবেন না। যেমন, কোনও পাবলিক কম্পিউটারে, কেউ আপনার টার্মিনাল উইন্ডো ইতিহাস বা রানিং প্রসেসের তালিকা দেখতে, পাসওয়ার্ড পেতে এবং তারপরে আপনার সাইনিং সার্টিফিকেটে লেখার অ্যাক্সেস পেতে পারে। এর ফলে সেই ব্যক্তি আপনার অ্যাপ পরিবর্তন করতে বা তার নিজের অ্যাপ দিয়ে সেটি পাল্টে দিতে পারবেন।

Google Developers Console থেকে API কী পান

Google Awareness API ব্যবহার শুরু করতে, কী পান বোতামে ক্লিক করুন। এটি Google Developers Console-এ লিঙ্ক করে, যা আপনাকে প্রসেসের মাধ্যমে গাইড করে এবং অটোমেটিক Awareness API অ্যাক্টিভেট করে।

'কী' পান

অন্যথায়, API key পেতে এইসব ধাপ অনুসরণ করুন:

1. Google Developers Console-এ যান।
2. একটি প্রোজেক্ট বেছে নিন অথবা নতুন একটি তৈরি করুন।
3. Awareness API চালু করতে চালিয়ে যান বিকল্পে ক্লিক করুন।

4. "ক্রেডেনশিয়াল" পৃষ্ঠায়, Android কী তৈরি করুন এবং API ক্রেডেনশিয়াল সেট করুন।

   মনে রাখবেন: আপনার কাছে আগে থেকেই Android কী থাকলে, আপনি সেটি ব্যবহার করতে পারবেন।

5. 'কী তৈরি করুন" ডায়ালগে, আপনাকে Android অ্যাপে ব্যবহার সীমাবদ্ধ করতে হবে। এটি করতে, আপনার অ্যাপের SHA-1 ফিঙ্গারপ্রিন্ট ও প্যাকেজের নাম লিখুন, যেমন নিচের উদাহরণে দেখানো হয়েছে:

   BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
   
   com.example.android.awareness-example
   

6. তৈরি করুন বিকল্পে ক্লিক করুন। আপনার প্রোজেক্টের জন্য API কী-এর তালিকায় আপনার নতুন Android API কী দেখা যাবে। API key হল অক্ষরের একটি স্ট্রিং, যেমন:

   AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0
   

এখন যেহেতু আপনার কাছে API কী আছে, তাই শুরু করা যাক নির্দেশিকায় বর্ণিত পদ্ধতি অনুযায়ী, আপনি এটি নিজের অ্যাপের ম্যানিফেস্টে যোগ করতে পারবেন।

অতিরিক্ত API অ্যাক্টিভেট করা

Awareness API আপনাকে একাধিক ধরনের প্রাসঙ্গিক ডেটা অ্যাক্সেস করার অনুমতি দেয়, যেমন বিকন। এইসব ধরন ব্যবহার করতে, আপনাকে Google Developers Console-এ সংশ্লিষ্ট API চালু করতে হবে।

পরিষেবা	Awareness API পদ্ধতি	চালু করার জন্য API
বিকন	SnapshotApi.getBeaconState(), FenceApi.BeaconFence	Nearby Messages API