এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

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

অপ্রচলিত হওয়ার বিজ্ঞপ্তি: অ্যাওয়ারনেস এপিআই অপ্রচলিত হয়ে গেছে।

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

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

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

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

আপনার অ্যাপের সার্টিফিকেট সম্পর্কে তথ্য জানুন।
গুগল ডেভেলপারস কনসোলে একটি প্রজেক্ট রেজিস্টার করুন এবং প্রজেক্টটির জন্য ইউজার কনটেক্সট এপিআই-কে একটি সার্ভিস হিসেবে যুক্ত করুন।
একটি চাবির জন্য অনুরোধ করুন।
আপনার অ্যাপে কী-টি যোগ করুন। এটি করার জন্য, আপনার অ্যাপ ম্যানিফেস্টে একটি এলিমেন্ট যোগ করুন।

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

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

ডিবাগ সার্টিফিকেট : আপনি যখন একটি ডিবাগ বিল্ড করেন, তখন অ্যান্ড্রয়েড এসডিকে টুলস স্বয়ংক্রিয়ভাবে এই সার্টিফিকেটটি তৈরি করে। শুধুমাত্র পরীক্ষাধীন অ্যাপের সাথেই এই সার্টিফিকেটটি ব্যবহার করুন। ডিবাগ সার্টিফিকেট দিয়ে স্বাক্ষরিত কোনো অ্যাপ প্রকাশ করার চেষ্টা করবেন না। অ্যান্ড্রয়েড ডেভেলপার ডকুমেন্টেশনের 'আপনার ডিবাগ বিল্ড স্বাক্ষর করুন' (Sign your debug build) বিভাগে ডিবাগ সার্টিফিকেট সম্পর্কে আরও বিস্তারিত বর্ণনা করা হয়েছে।
রিলিজ সার্টিফিকেট : আপনি যখন একটি রিলিজ বিল্ড করেন, তখন অ্যান্ড্রয়েড এসডিকে টুলস এই সার্টিফিকেটটি তৈরি করে। আপনি keytool প্রোগ্রাম ব্যবহার করেও এই সার্টিফিকেটটি তৈরি করতে পারেন। যখন আপনি আপনার অ্যাপটি বিশ্বব্যাপী রিলিজ করার জন্য প্রস্তুত হবেন, তখন এই সার্টিফিকেটটি ব্যবহার করুন।

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

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

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

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

আপনার ডিবাগ কীস্টোর ফাইলটি খুঁজুন। ফাইলটির নাম হলো debug.keystore , এবং আপনি যখন প্রথমবার আপনার প্রজেক্ট বিল্ড করেন তখন এটি তৈরি হয়। ডিফল্টরূপে, এটি আপনার অ্যান্ড্রয়েড ভার্চুয়াল ডিভাইস (AVD) ফাইলগুলির সাথে একই ডিরেক্টরিতে সংরক্ষিত থাকে:
- OS X এবং Linux : ~/.android/
- উইন্ডোজ ভিস্তা এবং উইন্ডোজ ৭ : C:\Users\your_user_name\.android\
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

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

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

আপনার রিলিজ সার্টিফিকেট কীস্টোর ফাইলটি খুঁজে বের করুন। রিলিজ কীস্টোরের কোনো ডিফল্ট অবস্থান বা নাম নেই। রিলিজের জন্য আপনার অ্যাপ বিল্ড করার সময় যদি আপনি এটি নির্দিষ্ট না করেন, তাহলে বিল্ডটি আপনার .apk স্বাক্ষরবিহীন রাখে এবং এটি প্রকাশ করার আগে আপনাকে এটিতে স্বাক্ষর করতে হবে। রিলিজ সার্টিফিকেটের জন্য, আপনার সার্টিফিকেটের অ্যালিয়াস, কীস্টোরের পাসওয়ার্ড এবং সার্টিফিকেটটিও প্রয়োজন হবে।
একটি কীস্টোরে থাকা সমস্ত কী-এর অ্যালিয়াসগুলো তালিকাভুক্ত করতে নিম্নলিখিতটি প্রবেশ করান:
```
keytool -list -keystore your_keystore_name
      
```
your_keystore_name জায়গায় কীস্টোরটির সম্পূর্ণ পাথ এবং নাম লিখুন। .keystore এক্সটেনশনটি অন্তর্ভুক্ত করুন। অনুরোধ করা হলে কীস্টোরটির পাসওয়ার্ড দিন। এরপর, keytool কীস্টোরের সমস্ত অ্যালিয়াস প্রদর্শন করবে।
টার্মিনাল বা কমান্ড প্রম্পটে নিম্নলিখিতটি লিখুন:
```
      keytool -list -v -keystore your_keystore_name -alias your_alias_name
      
```
your_keystore_name জায়গায় কীস্টোরটির সম্পূর্ণ পাথ এবং নাম লিখুন। .keystore এক্সটেনশনটি অন্তর্ভুক্ত করুন।
সার্টিফিকেটটি তৈরি করার সময় আপনি যে অ্যালিয়াসটি দিয়েছিলেন, সেটি দিয়ে 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 Awareness API ব্যবহার শুরু করতে, 'Get a key' বোতামটিতে ক্লিক করুন। এটি আপনাকে Google Developers Console-এ নিয়ে যাবে, যা আপনাকে পুরো প্রক্রিয়াটিতে নির্দেশনা দেবে এবং Awareness API-টি স্বয়ংক্রিয়ভাবে সক্রিয় করে দেবে।

একটি চাবি নিন

বিকল্পভাবে, একটি এপিআই কী পেতে এই ধাপগুলো অনুসরণ করুন:

গুগল ডেভেলপার কনসোলে যান।
একটি প্রকল্প নির্বাচন করুন, অথবা একটি নতুন প্রকল্প তৈরি করুন।
অ্যাওয়ারনেস এপিআই সক্রিয় করতে ' চালিয়ে যান'- এ ক্লিক করুন।
"Credentials" পেজে একটি অ্যান্ড্রয়েড কী তৈরি করুন এবং API ক্রেডেনশিয়াল সেট করুন।
দ্রষ্টব্য: আপনার যদি আগে থেকে কোনো অ্যান্ড্রয়েড কী থাকে, তবে আপনি সেটি ব্যবহার করতে পারেন।
'Create key' ডায়ালগে, আপনাকে এর ব্যবহার শুধুমাত্র অ্যান্ড্রয়েড অ্যাপের মধ্যে সীমাবদ্ধ করতে হবে। এটি করার জন্য, নিচের উদাহরণের মতো করে আপনার অ্যাপের 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
```
Create-এ ক্লিক করুন। আপনার নতুন অ্যান্ড্রয়েড এপিআই কী আপনার প্রোজেক্টের এপিআই কী-গুলোর তালিকায় দেখা যাবে। এপিআই কী হলো কয়েকটি অক্ষরের একটি স্ট্রিং, যেমনটি নিচে দেখানো হলো:
```
AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0
```

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

অতিরিক্ত এপিআই সক্রিয় করুন

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

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