সাইন-আপ ও API কী

বন্ধ হয়ে যাওয়ার বিজ্ঞপ্তি: Awareness API বন্ধ হয়ে গেছে।

সতর্কতা: Awareness API বন্ধ করে দেওয়া হয়েছে।

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

Google Awareness API ব্যবহার করতে, আপনার অ্যাপে Google 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-এর সম্পূর্ণভাবে উপযুক্ত পাথ ও নাম লিখুন। .keystore এক্সটেনশন অন্তর্ভুক্ত করুন। প্রম্পট করা হলে, keystore-এর পাসওয়ার্ড লিখুন। তারপর, keytool কীস্টোরে সব উপনাম দেখায়।

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

         keytool -list -v -keystore your_keystore_name -alias your_alias_name
         

5. your_keystore_name-এর জায়গায় keystore-এর সম্পূর্ণ উপযুক্ত পাথ ও নাম লিখুন। .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 ফিঙ্গারপ্রিন্ট আছে। ফিঙ্গারপ্রিন্ট হল কোলন দ্বারা আলাদা করা ২০টি দুই-সংখ্যার হেক্সাডেসিমেল নম্বরের ক্রম।

সতর্কতা: আপনার keystore ও কী সুরক্ষিত রাখতে, কম্পিউটারের নিরাপত্তা সম্পর্কে নিশ্চিত না হয়ে কমান্ড লাইনে 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