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 Console-এর Age signals পৃষ্ঠায় আপনার অ্যাপের জন্য এই ন্যূনতম বয়সগুলি প্রদান করতে পারেন। Age Signals API কাস্টমাইজড বয়সের সীমা প্রদান করে। উদাহরণস্বরূপ, যদি আপনি ন্যূনতম বয়স 9, 15 এবং 17 বছর প্রদান করেন, তাহলে একজন 14 বছর বয়সী ব্যবহারকারী 10-15 বছর বয়সের সীমার মধ্যে পড়বেন। ন্যূনতম বয়সের মধ্যে কমপক্ষে 2 বছর ব্যবধান থাকতে হবে এবং বছরে একবার পরিবর্তন করা যেতে পারে।
Age Signals API দ্বারা প্রদত্ত বয়সের সীমা কাস্টমাইজ করতে, আপনি আপনার অ্যাপের জন্য সর্বনিম্ন বয়স প্রদান করতে পারেন:
- আপনার প্লে কনসোলের বয়স সংকেত পৃষ্ঠায় যান।
- অ্যাপের সর্বনিম্ন বয়স ট্যাবে, আপনার অ্যাপের জন্য সর্বাধিক তিনটি সর্বনিম্ন বয়স লিখুন।
- সংরক্ষণ করুন ক্লিক করুন।
বয়সের সংকেতের প্রতিক্রিয়া
Play Age Signals API (বিটা) প্রতিক্রিয়াতে নিম্নলিখিত ক্ষেত্র এবং মান অন্তর্ভুক্ত থাকে। মানগুলি পরিবর্তন সাপেক্ষে। আপনি যদি সাম্প্রতিকতম মানগুলি চান, তাহলে আপনার অ্যাপটি খোলার সময় একটি API প্রতিক্রিয়ার অনুরোধ করুন। এই সংকেতগুলি ব্যবহার করে বয়স-উপযুক্ত অভিজ্ঞতা প্রদানের জন্য আপনার দায়িত্ব।
প্রতিক্রিয়া ক্ষেত্র | মূল্যবোধ | বিবরণ |
---|---|---|
userStatus | যাচাইকৃত | ব্যবহারকারীর বয়স ১৮ বছরের বেশি। Google সরকার কর্তৃক জারি করা আইডি, ক্রেডিট কার্ড, অথবা মুখের বয়স অনুমানের মতো বাণিজ্যিকভাবে যুক্তিসঙ্গত পদ্ধতি ব্যবহার করে ব্যবহারকারীর বয়স যাচাই করেছে। |
তত্ত্বাবধানে | ব্যবহারকারীর একটি তত্ত্বাবধানে থাকা Google অ্যাকাউন্ট আছে যা একজন অভিভাবক দ্বারা পরিচালিত হয় এবং তিনি তার বয়স নির্ধারণ করেন। ব্যবহারকারীর বয়সসীমা নির্ধারণ করতে ageLower এবং ageUpper ব্যবহার করুন। | |
তত্ত্বাবধানে_অনুমোদিত_অপেক্ষাকৃত | ব্যবহারকারীর একটি তত্ত্বাবধানে থাকা Google অ্যাকাউন্ট আছে এবং তাদের তত্ত্বাবধানকারী অভিভাবক এখনও এক বা একাধিক মুলতুবি থাকা উল্লেখযোগ্য পরিবর্তন অনুমোদন করেননি। ব্যবহারকারীর বয়সসীমা নির্ধারণ করতে ageLower এবং ageUpper ব্যবহার করুন। অনুমোদিত সর্বশেষ উল্লেখযোগ্য পরিবর্তন নির্ধারণ করতে mostRecentApprovalDate ব্যবহার করুন। | |
তত্ত্বাবধানে_অনুমোদিত_অস্বীকৃত | ব্যবহারকারীর একটি তত্ত্বাবধানে থাকা Google অ্যাকাউন্ট আছে এবং তার তত্ত্বাবধানকারী অভিভাবক এক বা একাধিক উল্লেখযোগ্য পরিবর্তনের জন্য অনুমোদন প্রত্যাখ্যান করেছেন। ব্যবহারকারীর বয়সসীমা নির্ধারণ করতে ageLower এবং ageUpper ব্যবহার করুন। অনুমোদিত সর্বশেষ উল্লেখযোগ্য পরিবর্তন নির্ধারণ করতে mostRecentApprovalDate ব্যবহার করুন। | |
অজানা | প্রযোজ্য বিচারব্যবস্থা এবং অঞ্চলে ব্যবহারকারী যাচাইকৃত বা তত্ত্বাবধানে নেই। এই ব্যবহারকারীদের বয়স ১৮ বছরের বেশি বা তার কম হতে পারে। Google Play থেকে বয়সের সংকেত পেতে, ব্যবহারকারীকে তাদের স্থিতি সমাধানের জন্য Play Store-এ যেতে বলুন। | |
খালি (একটি ফাঁকা মান) | অন্যান্য সকল ব্যবহারকারী এই মানটি ফেরত দেয়। | |
ageLower | ০ থেকে ১৮ | তত্ত্বাবধানে থাকা ব্যবহারকারীর বয়সসীমার (সমেত) নিম্ন সীমা। ব্যবহারকারীর বয়সসীমা নির্ধারণ করতে ageLower এবং ageUpper ব্যবহার করুন। |
খালি (একটি ফাঁকা মান) | userStatus অজানা অথবা খালি। | |
ageUpper | ২ থেকে ১৮ | একজন তত্ত্বাবধানে থাকা ব্যবহারকারীর বয়সসীমার (সমেত) উপরের সীমা। ব্যবহারকারীর বয়সসীমা নির্ধারণ করতে ageLower এবং ageUpper ব্যবহার করুন। |
খালি (একটি ফাঁকা মান) | হয় userStatus তত্ত্বাবধানে আছে এবং ব্যবহারকারীর পিতামাতার দ্বারা প্রত্যয়িত বয়স ১৮ বছরের বেশি। অথবা userStatus যাচাইকৃত, অজানা, অথবা খালি। | |
mostRecentApprovalDate | তারিখ স্ট্যাম্প | অনুমোদিত সাম্প্রতিকতম উল্লেখযোগ্য পরিবর্তনের তারিখ effective from । যখন একটি অ্যাপ ইনস্টল করা হয়, তখন ইনস্টলের পূর্বে সাম্প্রতিকতম উল্লেখযোগ্য পরিবর্তনের তারিখ ব্যবহার করা হয়। |
খালি (একটি ফাঁকা মান) | হয় userStatus তত্ত্বাবধানে আছে এবং কোনও উল্লেখযোগ্য পরিবর্তন জমা দেওয়া হয়নি। অথবা userStatus যাচাইকৃত, অজানা, অথবা খালি। | |
installID | প্লে-জেনারেটেড আলফানিউমেরিক আইডি। | Google Play দ্বারা তত্ত্বাবধানে থাকা ব্যবহারকারীর ইনস্টলেশনের জন্য নির্ধারিত একটি আইডি, যা আপনাকে প্রত্যাহার করা অ্যাপ অনুমোদনের বিষয়ে অবহিত করার উদ্দেশ্যে ব্যবহৃত হয়। প্রত্যাহার করা অ্যাপ অনুমোদনের জন্য ডকুমেন্টেশন পর্যালোচনা করুন। |
খালি (একটি ফাঁকা মান) | userStatus যাচাইকৃত, অজানা, অথবা খালি। |
API ত্রুটি কোডগুলি পরিচালনা করুন
যদি আপনার অ্যাপটি Play Age Signals API (বিটা) অনুরোধ করে এবং কলটি ব্যর্থ হয়, তাহলে আপনার অ্যাপটি একটি ত্রুটি কোড পাবে। এই ত্রুটিগুলি বিভিন্ন কারণে ঘটতে পারে, যেমন Play Store অ্যাপটি পুরানো হয়ে যাওয়া।
পুনরায় চেষ্টা করার কৌশল
ব্যবহারকারী যখন সেশনে থাকেন, তখন আমরা প্রস্থানের শর্ত হিসেবে সর্বাধিক সংখ্যক প্রচেষ্টা সহ একটি পুনঃচেষ্টা কৌশল বাস্তবায়নের পরামর্শ দিই যাতে ত্রুটিটি ব্যবহারকারীর অভিজ্ঞতাকে যতটা সম্ভব কম ব্যাহত করে।
ত্রুটি কোডের সংখ্যাসূচক মান | ত্রুটি কোড | বিবরণ | পুনরায় চেষ্টা করা যাবে |
---|---|---|---|
-১ | API_অনুপস্থিত_ | Play Age Signals API উপলব্ধ নেই। ডিভাইসে ইনস্টল করা Play Store অ্যাপ ভার্সনটি পুরনো হতে পারে। সম্ভাব্য সমাধান
| হাঁ |
-২ | PLAY_STORE_NOT_FOUND সম্পর্কে | ডিভাইসে কোনও Play Store অ্যাপ পাওয়া যায়নি। ব্যবহারকারীকে Play Store ইনস্টল বা সক্ষম করতে বলুন। | হাঁ |
-৩ | নেটওয়ার্ক_ত্রুটি | কোনও উপলব্ধ নেটওয়ার্ক খুঁজে পাওয়া যায়নি। ব্যবহারকারীকে সংযোগ পরীক্ষা করতে বলুন। | হাঁ |
-৪ | PLAY_SERVICES_NOT_FOUND সম্পর্কে | Play Services উপলব্ধ নেই অথবা এর ভার্সনটি অনেক পুরনো। ব্যবহারকারীকে Play Services ইনস্টল, আপডেট বা সক্ষম করতে বলুন। | হাঁ |
-৫ | পরিষেবা বাঁধতে_পারব না | Play Store-এ পরিষেবাটির সাথে বাইন্ডিং ব্যর্থ হয়েছে। ডিভাইসে একটি পুরানো Play Store সংস্করণ ইনস্টল থাকার কারণে অথবা ডিভাইসের মেমোরি ওভারলোড হওয়ার কারণে এটি হতে পারে। ব্যবহারকারীকে Play Store অ্যাপটি আপডেট করতে বলুন। একটি সূচকীয় ব্যাকঅফ দিয়ে আবার চেষ্টা করুন। | হাঁ |
-৬ | PLAY_STORE_VERSION_অপ্রচলিত | প্লে স্টোর অ্যাপটি আপডেট করা প্রয়োজন। ব্যবহারকারীকে প্লে স্টোর অ্যাপটি আপডেট করতে বলুন। | হাঁ |
-৭ | PLAY_SERVICES_VERSION_অপ্রচলিত | প্লে পরিষেবাগুলি আপডেট করা প্রয়োজন। ব্যবহারকারীকে প্লে পরিষেবাগুলি আপডেট করতে বলুন। | হাঁ |
-৮ | ক্লায়েন্ট_ট্রান্সিয়েন্ট_ত্রুটি | ক্লায়েন্ট ডিভাইসে একটি ক্ষণস্থায়ী ত্রুটি ছিল। প্রস্থান শর্ত হিসেবে সর্বাধিক সংখ্যক প্রচেষ্টা সহ একটি পুনরায় চেষ্টা কৌশল বাস্তবায়ন করুন। যদি সমস্যাটি এখনও সমাধান না হয়, তাহলে ব্যবহারকারীকে পরে আবার চেষ্টা করতে বলুন। | হাঁ |
-৯ | অ্যাপ_অন_মালিকানাধীন | অ্যাপটি Google Play দ্বারা ইনস্টল করা হয়নি। ব্যবহারকারীকে Google Play থেকে আপনার অ্যাপটি পেতে বলুন। | না |
-১০০ | অভ্যন্তরীণ_ত্রুটি | অজানা অভ্যন্তরীণ ত্রুটি। প্রস্থানের শর্ত হিসেবে সর্বাধিক সংখ্যক প্রচেষ্টা সহ একটি পুনরায় চেষ্টা কৌশল বাস্তবায়ন করুন। যদি সমস্যাটি এখনও সমাধান না হয়, তাহলে ব্যবহারকারীকে পরে আবার চেষ্টা করতে বলুন। যদি এটি ধারাবাহিকভাবে ব্যর্থ হয়, তাহলে Google Play ডেভেলপার সহায়তার সাথে যোগাযোগ করুন , বিষয়টিতে Play Age Signals API অন্তর্ভুক্ত করুন এবং যতটা সম্ভব প্রযুক্তিগত বিবরণ অন্তর্ভুক্ত করুন (যেমন একটি বাগ রিপোর্ট)। | না |