সাইনআপ এবং API কী

Google Awareness API ব্যবহার করতে, আপনাকে অবশ্যই আপনার অ্যাপে একটি Google API কী যোগ করতে হবে। আপনার যে ধরনের API কী প্রয়োজন তা হল একটি Android API কী।

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

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

আপনার অ্যাপ্লিকেশানের জন্য একটি কী পেতে আপনার জন্য বেশ কয়েকটি পদক্ষেপের প্রয়োজন৷ সেগুলি এই নির্দেশিকায় বিশদভাবে বর্ণনা করা হয়েছে, এবং নিম্নরূপ সংক্ষিপ্ত করা হয়েছে:

1. আপনার অ্যাপের শংসাপত্র সম্পর্কে তথ্য পান।
2. Google বিকাশকারী কনসোলে একটি প্রকল্প নিবন্ধন করুন এবং প্রকল্পের জন্য একটি পরিষেবা হিসাবে ব্যবহারকারী প্রসঙ্গ API যোগ করুন৷
3. একটি চাবি অনুরোধ.
4. আপনার অ্যাপে কী যোগ করুন। এটি করতে, আপনার অ্যাপ ম্যানিফেস্টে একটি উপাদান যোগ করুন।

আপনার অ্যাপের শংসাপত্রের তথ্য খুঁজুন

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

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

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

ডিবাগ শংসাপত্র

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

একটি শংসাপত্রের 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 ফিঙ্গারপ্রিন্ট তালিকাভুক্ত করুন:

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

     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 ফিঙ্গারপ্রিন্ট রয়েছে। আঙুলের ছাপ হল কোলন দ্বারা পৃথক করা 20টি দুই-অঙ্কের হেক্সাডেসিমেল সংখ্যার ক্রম।

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

Google Developers Console থেকে একটি API কী পান৷

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

একটা চাবি নাও

বিকল্পভাবে, একটি API কী পেতে এই পদক্ষেপগুলি অনুসরণ করুন:

1. Google Developers Console- এ যান।
2. একটি প্রকল্প নির্বাচন করুন, বা একটি নতুন তৈরি করুন৷
3. সচেতনতা API সক্ষম করতে অবিরত ক্লিক করুন।

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

   দ্রষ্টব্য: আপনার যদি একটি বিদ্যমান অ্যান্ড্রয়েড কী থাকে তবে আপনি এটি ব্যবহার করতে পারেন।

5. 'কী তৈরি করুন' ডায়ালগে, আপনাকে অ্যান্ড্রয়েড অ্যাপে আপনার ব্যবহার সীমাবদ্ধ করতে হবে। এটি করতে, আপনার অ্যাপের 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. তৈরি করুন ক্লিক করুন। আপনার নতুন Android API কী আপনার প্রকল্পের জন্য API কীগুলির তালিকায় প্রদর্শিত হবে৷ একটি API কী হল অক্ষরের একটি স্ট্রিং, যেমন:

   AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0
   

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

অতিরিক্ত API সক্রিয় করুন

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

সেবা	সচেতনতা API পদ্ধতি	এপিআই সক্ষম করতে
বীকন	SnapshotApi.getBeaconState() , FenceApi.BeaconFence	কাছাকাছি বার্তা API