এই ডকুমেন্টেশনটি মার্কিন যুক্তরাষ্ট্রের প্রযোজ্য রাজ্যগুলিতে আসন্ন বয়স যাচাইকরণ বিলের আগে শেয়ার করা হচ্ছে, যা ১ জানুয়ারী, ২০২৬ থেকে টেক্সাসে কার্যকর হবে। ১ জানুয়ারী, ২০২৬ থেকে প্রযোজ্য ব্যবহারকারীদের জন্য লাইভ প্রতিক্রিয়া পেতে Play Age Signals API (বিটা) এর লাইব্রেরি সংস্করণ ০.০.২ বা তার বেশি ব্যবহার করুন। এই তারিখের পরে Play Console-এ Age Signals পৃষ্ঠাটিও পাওয়া যাবে।

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

Play Age Signals API (বিটা) ব্যবহার করুন

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 Android 6.0 (API লেভেল 23) এবং তার পরবর্তী সংস্করণে সমর্থিত। আপনার অ্যাপে Play Age Signals API ইন্টিগ্রেট করতে, আপনার অ্যাপের build.gradle ফাইলে নিম্নলিখিত নির্ভরতা যোগ করুন:

implementation 'com.google.android.play:age-signals:0.0.2'

বয়সের সংকেতের জন্য অনুরোধ করুন

বয়স সংকেত অনুরোধ করার একটি উদাহরণ এখানে দেওয়া হল:

কোটলিন

// Create an instance of a manager
val ageSignalsManager =
    AgeSignalsManagerFactory.create(ApplicationProvider.getApplicationContext())

// Request an age signals check
ageSignalsManager
    .checkAgeSignals(AgeSignalsRequest.builder().build())
    .addOnSuccessListener { ageSignalsResult ->
        // Store the install ID for later...
        val installId = ageSignalsResult.installId()

        if (ageSignalsResult.userStatus() == AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_DENIED) {
          // Disallow access...
        } else {
           // Do something else if the user is SUPERVISED, VERIFIED, etc.
        }
    }

জাভা

// 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 বয়সের সীমার মধ্যে পড়বেন।

Age Signals API দ্বারা প্রদত্ত বয়সের সীমা কাস্টমাইজ করতে, আপনি আপনার অ্যাপের জন্য সর্বনিম্ন বয়স প্রদান করতে পারেন:

আপনার প্লে কনসোলের বয়স সংকেত পৃষ্ঠায় যান।
কাস্টম বয়সের সীমা ট্যাবে, আপনার অ্যাপের জন্য সর্বাধিক তিনটি বয়স লিখুন। সর্বনিম্ন বয়সের মধ্যে কমপক্ষে ২ বছরের ব্যবধান থাকতে হবে এবং বছরে একবার পরিবর্তন করা যেতে পারে।
সংরক্ষণ করুন ক্লিক করুন।

বয়সের সংকেতের প্রতিক্রিয়া

Play Age Signals API (বিটা) প্রতিক্রিয়াতে নিম্নলিখিত ক্ষেত্র এবং মান অন্তর্ভুক্ত থাকে। মানগুলি পরিবর্তন সাপেক্ষে। আপনি যদি সাম্প্রতিকতম মানগুলি চান, তাহলে আপনার অ্যাপটি খোলার সময় একটি API প্রতিক্রিয়ার অনুরোধ করুন। এই সংকেতগুলি ব্যবহার করে বয়স-উপযুক্ত অভিজ্ঞতা প্রদানের জন্য আপনার দায়িত্ব।

প্রতিক্রিয়া ক্ষেত্র	মূল্যবোধ	বিবরণ
`userStatus`	যাচাইকৃত	ব্যবহারকারীর বয়স ১৮ বছরের বেশি। Google সরকার কর্তৃক জারি করা আইডি, ক্রেডিট কার্ড, অথবা মুখের বয়স অনুমানের মতো বাণিজ্যিকভাবে যুক্তিসঙ্গত পদ্ধতি ব্যবহার করে ব্যবহারকারীর বয়স যাচাই করেছে। যদি `userStatus` `VERIFIED` হয়, তাহলে আপনি অন্যান্য ক্ষেত্রগুলি উপেক্ষা করতে পারেন।
	তত্ত্বাবধানে	ব্যবহারকারীর একটি তত্ত্বাবধানে থাকা Google অ্যাকাউন্ট আছে যা একজন অভিভাবক দ্বারা পরিচালিত হয় এবং তিনি তার বয়স নির্ধারণ করেন। ব্যবহারকারীর বয়সসীমা নির্ধারণ করতে `ageLower` এবং `ageUpper` ব্যবহার করুন। অনুমোদিত সর্বশেষ উল্লেখযোগ্য পরিবর্তন নির্ধারণ করতে `mostRecentApprovalDate` ব্যবহার করুন।
	তত্ত্বাবধানে_অনুমোদিত_অপেক্ষাকৃত	ব্যবহারকারীর একটি তত্ত্বাবধানে থাকা Google অ্যাকাউন্ট আছে এবং তাদের তত্ত্বাবধানকারী অভিভাবক এখনও এক বা একাধিক মুলতুবি থাকা উল্লেখযোগ্য পরিবর্তন অনুমোদন করেননি। ব্যবহারকারীর বয়সসীমা নির্ধারণ করতে `ageLower` এবং `ageUpper` ব্যবহার করুন। অনুমোদিত সর্বশেষ উল্লেখযোগ্য পরিবর্তন নির্ধারণ করতে `mostRecentApprovalDate` ব্যবহার করুন।
	তত্ত্বাবধানে_অনুমোদিত_অস্বীকৃত	ব্যবহারকারীর একটি তত্ত্বাবধানে থাকা Google অ্যাকাউন্ট আছে এবং তার তত্ত্বাবধানকারী অভিভাবক এক বা একাধিক উল্লেখযোগ্য পরিবর্তনের জন্য অনুমোদন প্রত্যাখ্যান করেছেন। ব্যবহারকারীর বয়সসীমা নির্ধারণ করতে `ageLower` এবং `ageUpper` ব্যবহার করুন। অনুমোদিত সর্বশেষ উল্লেখযোগ্য পরিবর্তন নির্ধারণ করতে `mostRecentApprovalDate` ব্যবহার করুন।
	অজানা	ব্যবহারকারী কোনও প্রযোজ্য অধিক্ষেত্র বা অঞ্চলে আছেন, কিন্তু যাচাইকৃত বা তত্ত্বাবধানে নেই। এই ব্যবহারকারীদের বয়স ১৮ বছরের বেশি বা তার কম হতে পারে। Google Play থেকে বয়সের সংকেত পেতে, ব্যবহারকারীকে তাদের স্থিতি সমাধানের জন্য Play Store-এ যেতে বলুন।
	`null`	অন্য সকল ব্যবহারকারী এই মানটি প্রদান করে। যদি `userStatus` `null` হয়, তাহলে আপনি অন্যান্য ক্ষেত্রগুলি উপেক্ষা করতে পারেন।
`ageLower`	০ থেকে ১৮	তত্ত্বাবধানে থাকা ব্যবহারকারীর বয়সসীমার (সমেত) নিম্ন সীমা। ব্যবহারকারীর বয়সসীমা নির্ধারণ করতে `ageLower` এবং `ageUpper` ব্যবহার করুন।
`ageLower`	`null`	`userStatus` অজানা অথবা খালি।
`ageUpper`	২ থেকে ১৮	একজন তত্ত্বাবধানে থাকা ব্যবহারকারীর বয়সসীমার (সমেত) উপরের সীমা। ব্যবহারকারীর বয়সসীমা নির্ধারণ করতে `ageLower` এবং `ageUpper` ব্যবহার করুন।
`ageUpper`	`null`	হয় `userStatus` তত্ত্বাবধানে আছে এবং ব্যবহারকারীর পিতামাতার দ্বারা প্রত্যয়িত বয়স ১৮ বছরের বেশি। অথবা `userStatus` যাচাইকৃত, অজানা, অথবা খালি।
`mostRecentApprovalDate`	তারিখ স্ট্যাম্প	অনুমোদিত সাম্প্রতিকতম উল্লেখযোগ্য পরিবর্তনের তারিখ `effective from` । যখন একটি অ্যাপ ইনস্টল করা হয়, তখন ইনস্টলের পূর্বে সাম্প্রতিকতম উল্লেখযোগ্য পরিবর্তনের তারিখ ব্যবহার করা হয়।
`mostRecentApprovalDate`	`null`	হয় `userStatus` তত্ত্বাবধানে আছে এবং কোনও উল্লেখযোগ্য পরিবর্তন জমা দেওয়া হয়নি। অথবা `userStatus` যাচাইকৃত, অজানা, অথবা খালি।
`installID`	প্লে-জেনারেটেড আলফানিউমেরিক আইডি।	Google Play দ্বারা তত্ত্বাবধানে থাকা ব্যবহারকারীর ইনস্টলেশনের জন্য নির্ধারিত একটি আইডি, যা আপনাকে প্রত্যাহার করা অ্যাপ অনুমোদনের বিষয়ে অবহিত করার উদ্দেশ্যে ব্যবহৃত হয়। প্রত্যাহার করা অ্যাপ অনুমোদনের জন্য ডকুমেন্টেশন পর্যালোচনা করুন।
`installID`	`null`	`userStatus` যাচাইকৃত, অজানা, অথবা খালি।

উদাহরণ প্রতিক্রিয়া

একজন যাচাইকৃত ব্যবহারকারীর জন্য, আপনি নিম্নলিখিতগুলি পাবেন:

userStatus হবে AgeSignalsVerificationStatus.VERIFIED ।
অন্যান্য প্রতিক্রিয়া ক্ষেত্রগুলি খালি থাকবে।

একজন তত্ত্বাবধানে থাকা ব্যবহারকারীর জন্য, আপনি নিম্নলিখিতগুলি পাবেন:

userStatus হবে AgeSignalsVerificationStatus.SUPERVISED ।
ageLower একটি সংখ্যা হবে (যেমন ১৩)।
ageUpper একটি সংখ্যা হবে (যেমন 15)।
mostRecentApprovalDate একটি জাভা তারিখ বস্তু হবে (যেমন 2026-01-01 ) অথবা খালি (যদি কোন উল্লেখযোগ্য পরিবর্তন অনুমোদিত না হয়)।
installID হবে একটি Play-জেনারেটেড আলফানিউমেরিক আইডি (যেমন 550e8400-e29b-41d4-a716-446655441111 )।

একজন তত্ত্বাবধানে থাকা ব্যবহারকারীর জন্য যার উল্লেখযোগ্য পরিবর্তন অনুমোদনের অপেক্ষায় রয়েছে, আপনি নিম্নলিখিতগুলি পাবেন:

userStatus হবে AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING ।
ageLower একটি সংখ্যা হবে (যেমন ১৩)।
ageUpper একটি সংখ্যা হবে (যেমন 15)।
mostRecentApprovalDate একটি জাভা তারিখ বস্তু হবে (যেমন 2026-01-01 ) অথবা খালি (যদি কোন উল্লেখযোগ্য পরিবর্তন অনুমোদিত না হয়)।
installID হবে একটি Play-জেনারেটেড আলফানিউমেরিক আইডি (যেমন 550e8400-e29b-41d4-a716-446655441111 )।

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 অন্তর্ভুক্ত করুন এবং যতটা সম্ভব প্রযুক্তিগত বিবরণ অন্তর্ভুক্ত করুন (যেমন একটি বাগ রিপোর্ট)।	না

পূর্ববর্তী

ওভারভিউ

পরবর্তী

উল্লেখযোগ্য পরিবর্তনগুলি অবহিত করুন