Play Age Signals API (বিটা) ব্যবহার করে, আপনি পরিষেবার শর্তাবলীতে সম্মত হন এবং আপনি সমস্ত Google Play বিকাশকারী নীতি মেনে চলতে সম্মত হন৷ ব্যবহারকারীর স্থিতি এবং বয়স পরিসীমা অনুরোধ করতে, আপনি রানটাইমে আপনার অ্যাপ থেকে API কল করুন। Play Age Signals API শুধুমাত্র সেই অঞ্চলের ব্যবহারকারীদের জন্য ডেটা ফেরত দেয় যেখানে বয়স বিভাগের ডেটা প্রদানের জন্য আইন অনুসারে Play প্রয়োজন।
Play প্রযোজ্য এখতিয়ার এবং অঞ্চলগুলির দ্বারা নির্ধারিত বয়সের ব্যান্ডের উপর ভিত্তি করে একটি বয়সের সীমা প্রদান করে। প্রযোজ্য এখতিয়ার এবং অঞ্চলগুলিতে API যে ডিফল্ট বয়সগুলি ফেরত দেয় তা হল 0-12, 13-15, 16-17 এবং 18+ তবে আঞ্চলিক প্রয়োজনীয়তার ভিত্তিতে এগুলি পরিবর্তিত হতে পারে৷
আপনার অ্যাপে Play Age Signals API একীভূত করুন
আপনার অ্যাপে Play Age Signals API একত্রিত করতে, আপনার অ্যাপের build.gradle
ফাইলে নিম্নলিখিত নির্ভরতা যোগ করুন:
implementation 'com.google.android.play:age-signals:0.0.1-beta01'
বয়স সংকেত অনুরোধ
এখানে একটি বয়স সংকেত অনুরোধ করার একটি উদাহরণ:
// Create an instance of a manager
AgeSignalsManager ageSignalsManager =
AgeSignalsManagerFactory.create(ApplicationProvider.getApplicationContext());
// Request an age signals check
ageSignalsManager
.checkAgeSignals(AgeSignalsRequest.builder().build())
.addOnSuccessListener(
ageSignalsResult -> {
// Store the install ID for later...
String installId = ageSignalsResult.installId();
if (ageSignalsResult
.userStatus()
.equals(AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_DENIED)) {
// Disallow access ...
} else {
// Do something else if the user is SUPERVISED, VERIFIED, etc.
}
});
বয়স সংকেত প্রতিটি ব্যবহারকারীর জন্য ডিভাইসে Google Play দ্বারা সংরক্ষণ করা হয়। যখন তত্ত্বাবধানে থাকা Google অ্যাকাউন্টের কোনো ব্যবহারকারীর বয়স একটি নতুন বয়সের পরিসরে হয়, তখন Google Play স্বয়ংক্রিয়ভাবে ব্যবহারকারীর জন্মদিনের পর 2 থেকে 8 সপ্তাহের মধ্যে সেই ব্যবহারকারীর জন্য ক্যাশে করা বয়স সংকেত আপডেট করে।
(ঐচ্ছিক) কাস্টম বয়সের ব্যাপ্তি পান
ডিফল্ট বয়সের রেঞ্জ যা API প্রযোজ্য এখতিয়ার এবং অঞ্চলে ফেরত দেয় তা হল 0-12, 13-15, 16-17 এবং 18+। স্থানীয় প্রয়োজনের ভিত্তিতে ভবিষ্যতে এগুলি পরিবর্তিত হতে পারে।
বিকল্পভাবে, আপনার অ্যাপের ন্যূনতম বয়স অনুযায়ী বয়সের সীমাগুলি কাস্টমাইজ করতে, আপনি আপনার Google Play কনসোলের বয়স সংকেত পৃষ্ঠায় আপনার অ্যাপের জন্য এই ন্যূনতম বয়সগুলি প্রদান করতে পারেন। বয়স সংকেত API কাস্টমাইজ করা বয়স রেঞ্জ প্রদান করে। উদাহরণস্বরূপ, আপনি যদি ন্যূনতম বয়স 9, 15 এবং 17 প্রদান করেন, তাহলে একজন 14 বছর বয়সী ব্যবহারকারী 10-15 বয়সের সীমার মধ্যে পড়বে। ন্যূনতম বয়স কমপক্ষে 2 বছরের ব্যবধান হতে হবে এবং বছরে একবার পরিবর্তন করা যেতে পারে।
বয়স সংকেত API দ্বারা প্রত্যাবর্তিত বয়সের সীমাগুলি কাস্টমাইজ করতে, আপনি আপনার অ্যাপের জন্য সর্বনিম্ন বয়স প্রদান করতে পারেন:
- আপনার Play Console-এ বয়স সংকেত পৃষ্ঠায় যান।
- অ্যাপের ন্যূনতম বয়স ট্যাবে, আপনার অ্যাপের জন্য ন্যূনতম তিন পর্যন্ত বয়স লিখুন।
- সংরক্ষণ করুন ক্লিক করুন.
বয়স সংকেত প্রতিক্রিয়া
Play বয়স সংকেত API (বিটা) প্রতিক্রিয়া নিম্নলিখিত ক্ষেত্র এবং মান অন্তর্ভুক্ত। মান পরিবর্তন সাপেক্ষে. আপনি যদি সাম্প্রতিক মান চান, আপনার অ্যাপটি খোলার সময় একটি API প্রতিক্রিয়ার অনুরোধ করুন। এই সংকেতগুলি ব্যবহার করে বয়স-উপযুক্ত অভিজ্ঞতা প্রদানের জন্য আপনি দায়ী৷
প্রতিক্রিয়া ক্ষেত্র | মূল্যবোধ | বর্ণনা |
---|---|---|
userStatus | যাচাই করা হয়েছে | ব্যবহারকারীর বয়স 18-এর বেশি৷ Google একটি বাণিজ্যিকভাবে যুক্তিসঙ্গত পদ্ধতি যেমন সরকার-প্রদত্ত আইডি, ক্রেডিট কার্ড, বা মুখের বয়স অনুমান ব্যবহার করে ব্যবহারকারীর বয়স যাচাই করেছে৷ |
তত্ত্বাবধান করা হয়েছে | ব্যবহারকারীর একটি তত্ত্বাবধানে থাকা Google অ্যাকাউন্ট রয়েছে যা একজন অভিভাবক দ্বারা পরিচালিত হয় যারা তাদের বয়স নির্ধারণ করে। ব্যবহারকারীর বয়স পরিসীমা নির্ধারণ করতে ageLower এবং ageUpper ব্যবহার করুন। | |
SUPERVISED_APPROVAL_PENDING৷ | ব্যবহারকারীর একটি তত্ত্বাবধানে থাকা Google অ্যাকাউন্ট রয়েছে এবং তাদের তত্ত্বাবধায়ক অভিভাবক এখনও এক বা একাধিক গুরুত্বপূর্ণ পরিবর্তনগুলিকে অনুমোদন করেননি৷ ব্যবহারকারীর বয়স পরিসীমা নির্ধারণ করতে ageLower এবং ageUpper ব্যবহার করুন। অনুমোদিত সর্বশেষ উল্লেখযোগ্য পরিবর্তন নির্ধারণ করতে mostRecentApprovalDate ব্যবহার করুন। | |
SUPERVISED_APPROVAL_DENIED | ব্যবহারকারীর একটি তত্ত্বাবধান করা Google অ্যাকাউন্ট রয়েছে এবং তাদের তত্ত্বাবধায়ক অভিভাবক এক বা একাধিক উল্লেখযোগ্য পরিবর্তনের জন্য অনুমোদন অস্বীকার করেছেন৷ ব্যবহারকারীর বয়স পরিসীমা নির্ধারণ করতে ageLower এবং ageUpper ব্যবহার করুন। অনুমোদিত সর্বশেষ উল্লেখযোগ্য পরিবর্তন নির্ধারণ করতে mostRecentApprovalDate ব্যবহার করুন। | |
অজানা | ব্যবহারকারী প্রযোজ্য এখতিয়ার এবং অঞ্চলে যাচাই বা তদারকি করা হয় না। এই ব্যবহারকারীদের বয়স 18 বছরের বেশি বা তার কম হতে পারে। Google Play থেকে বয়সের সংকেত পেতে, ব্যবহারকারীকে তাদের স্থিতি সমাধান করতে Play Store-এ যেতে বলুন। | |
খালি (একটি ফাঁকা মান) | অন্যান্য সমস্ত ব্যবহারকারী এই মান ফেরত দেয়। | |
ageLower | 0 থেকে 18 | তত্ত্বাবধানে থাকা ব্যবহারকারীর বয়স সীমার (অন্তর্ভুক্ত) নিম্ন সীমা। ব্যবহারকারীর বয়স পরিসীমা নির্ধারণ করতে ageLower এবং ageUpper ব্যবহার করুন। |
খালি (একটি ফাঁকা মান) | userStatus অজানা বা খালি। | |
ageUpper | 2 থেকে 18 | তত্ত্বাবধানে থাকা ব্যবহারকারীর বয়স সীমার (অন্তর্ভুক্ত) উপরের সীমা। ব্যবহারকারীর বয়স পরিসীমা নির্ধারণ করতে ageLower এবং ageUpper ব্যবহার করুন। |
খালি (একটি ফাঁকা মান) | হয় userStatus তত্ত্বাবধানে রয়েছে এবং ব্যবহারকারীর পিতামাতার প্রত্যয়িত বয়স 18-এর বেশি। অথবা userStatus যাচাই করা, অজানা বা খালি। | |
mostRecentApprovalDate | ডেটস্ট্যাম্প | সবচেয়ে সাম্প্রতিক উল্লেখযোগ্য পরিবর্তনের তারিখ effective from যা অনুমোদিত হয়েছে। যখন একটি অ্যাপ ইনস্টল করা হয়, ইনস্টল করার আগে সবচেয়ে সাম্প্রতিক উল্লেখযোগ্য পরিবর্তনের তারিখ ব্যবহার করা হয়। |
খালি (একটি ফাঁকা মান) | হয় userStatus তত্ত্বাবধান করা হয় এবং কোন উল্লেখযোগ্য পরিবর্তন জমা দেওয়া হয়নি। অথবা userStatus যাচাই করা, অজানা বা খালি। | |
installID | প্লে-জেনারেটেড আলফানিউমেরিক আইডি। | Google Play-এর দ্বারা তত্ত্বাবধানে থাকা ব্যবহারকারীর ইনস্টলে বরাদ্দ করা একটি আইডি, অ্যাপের অনুমোদন প্রত্যাহার করার বিষয়ে আপনাকে জানানোর উদ্দেশ্যে ব্যবহার করা হয়। প্রত্যাহার করা অ্যাপ অনুমোদনের জন্য ডকুমেন্টেশন পর্যালোচনা করুন। |
খালি (একটি ফাঁকা মান) | userStatus যাচাই করা, অজানা বা খালি। |
API ত্রুটি কোডগুলি পরিচালনা করুন
যদি আপনার অ্যাপ প্লে এজ সিগন্যাল এপিআই (বিটা) অনুরোধ করে এবং কল ব্যর্থ হয়, তাহলে আপনার অ্যাপ একটি ত্রুটি কোড পায়। এই ত্রুটিগুলি বিভিন্ন কারণে ঘটতে পারে, যেমন প্লে স্টোর অ্যাপটি পুরানো।
কৌশল পুনরায় চেষ্টা করুন
ব্যবহারকারীর সেশনে থাকা পরিস্থিতিতে, আমরা প্রস্থান শর্ত হিসাবে সর্বাধিক সংখ্যক প্রচেষ্টা সহ একটি পুনরায় চেষ্টা করার কৌশল প্রয়োগ করার সুপারিশ করি যাতে ত্রুটিটি যতটা সম্ভব কম ব্যবহারকারীর অভিজ্ঞতাকে ব্যাহত করে।
ত্রুটি কোডের সংখ্যাসূচক মান | ত্রুটি কোড | বর্ণনা | পুনরায় চেষ্টা করা যায় |
---|---|---|---|
-1 | API_NOT_AVAILABLE | Play Age Signals API উপলব্ধ নেই৷ ডিভাইসে ইনস্টল করা প্লে স্টোর অ্যাপ সংস্করণটি পুরানো হতে পারে। সম্ভাব্য রেজোলিউশন
| হ্যাঁ |
-2 | PLAY_STORE_NOT_FOUND | ডিভাইসে কোনো প্লে স্টোর অ্যাপ পাওয়া যায়নি। ব্যবহারকারীকে প্লে স্টোর ইনস্টল বা সক্ষম করতে বলুন। | হ্যাঁ |
-3 | NETWORK_ERROR | কোন উপলব্ধ নেটওয়ার্ক পাওয়া যায় না. ব্যবহারকারীকে একটি সংযোগ পরীক্ষা করতে বলুন। | হ্যাঁ |
-4 | PLAY_SERVICES_NOT_FOUND | প্লে পরিষেবাগুলি উপলব্ধ নেই বা এর সংস্করণটি খুব পুরানো৷ ব্যবহারকারীকে Play পরিষেবাগুলি ইনস্টল, আপডেট বা সক্ষম করতে বলুন৷ | হ্যাঁ |
-5 | CANNOT_BIND_TO_SERVICE | প্লে স্টোরে পরিষেবার সাথে আবদ্ধ করা ব্যর্থ হয়েছে৷ এটি ডিভাইসে একটি পুরানো প্লে স্টোর সংস্করণ ইনস্টল করা বা ডিভাইসের মেমরি ওভারলোড হওয়ার কারণে হতে পারে। ব্যবহারকারীকে প্লে স্টোর অ্যাপ আপডেট করতে বলুন। একটি সূচকীয় ব্যাকঅফ দিয়ে পুনরায় চেষ্টা করুন। | হ্যাঁ |
-6 | PLAY_STORE_VERSION_OUTDATED | প্লে স্টোর অ্যাপটি আপডেট করতে হবে। ব্যবহারকারীকে প্লে স্টোর অ্যাপ আপডেট করতে বলুন। | হ্যাঁ |
-7 | PLAY_SERVICES_VERSION_OUTDATED | প্লে পরিষেবাগুলি আপডেট করা দরকার৷ ব্যবহারকারীকে প্লে সার্ভিস আপডেট করতে বলুন। | হ্যাঁ |
-8 | CLIENT_TRANSIENT_ERROR | ক্লায়েন্ট ডিভাইসে একটি ক্ষণস্থায়ী ত্রুটি ছিল। প্রস্থান শর্ত হিসাবে সর্বোচ্চ সংখ্যক প্রচেষ্টা সহ একটি পুনরায় চেষ্টা করার কৌশল প্রয়োগ করুন। যদি এখনও সমস্যাটি সমাধান না হয়, ব্যবহারকারীকে পরে আবার চেষ্টা করতে বলুন। | হ্যাঁ |
-9 | APP_NOT_OWNED | অ্যাপটি Google Play দ্বারা ইনস্টল করা হয়নি। ব্যবহারকারীকে Google Play থেকে আপনার অ্যাপ পেতে বলুন। | না |
-100 | অভ্যন্তরীণ_ত্রুটি | অজানা অভ্যন্তরীণ ত্রুটি৷ প্রস্থান শর্ত হিসাবে সর্বোচ্চ সংখ্যক প্রচেষ্টা সহ একটি পুনরায় চেষ্টা করার কৌশল প্রয়োগ করুন। যদি এখনও সমস্যাটি সমাধান না হয়, ব্যবহারকারীকে পরে আবার চেষ্টা করতে বলুন। এটি ধারাবাহিকভাবে ব্যর্থ হলে, Google Play বিকাশকারী সহায়তার সাথে যোগাযোগ করুন , বিষয়ের মধ্যে Play Age Signals API অন্তর্ভুক্ত করুন এবং যতটা সম্ভব প্রযুক্তিগত বিশদ অন্তর্ভুক্ত করুন (যেমন একটি বাগ রিপোর্ট)। | না |