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+ হয় তবে কাস্টম বয়স সীমা গ্রহণ করা যেতে পারে। Google Play ব্যবহারকারীর জন্মদিনের 2 থেকে 8 সপ্তাহের মধ্যে ব্যবহারকারীর জন্য ক্যাশ করা বয়স সংকেত স্বয়ংক্রিয়ভাবে আপডেট করে।

আপনার অ্যাপে 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.3'

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

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

কোটলিন 

// 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 VERIFIED, DECLARED, SUPERVISED, 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.
          }
        });

(ঐচ্ছিক) কাস্টম বয়সের ব্যাপ্তি পান

প্রযোজ্য বিচারব্যবস্থা এবং অঞ্চলে API যে ডিফল্ট বয়সসীমা প্রদান করে তা হল 0-12, 13-15, 16-17, এবং 18+।

বিকল্পভাবে, আপনার অ্যাপের ন্যূনতম বয়স অনুসারে ডিফল্ট বয়সের সীমা কাস্টমাইজ করতে, আপনি আপনার Google Play Console-এর বয়স সংকেত পৃষ্ঠায় আপনার অ্যাপের জন্য এই ন্যূনতম বয়সগুলি প্রদান করতে পারেন। ফিরে আসা বয়সের সীমাগুলি ডিফল্ট API প্রতিক্রিয়াকে ওভাররাইড করবে। উদাহরণস্বরূপ, যদি আপনি ন্যূনতম বয়স 9, 15 এবং 17 প্রদান করেন, তাহলে একজন 14 বছর বয়সী ব্যবহারকারী 10-15 বয়সের সীমার মধ্যে পড়বেন।

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

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

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

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

প্রতিক্রিয়া ক্ষেত্র মূল্যবোধ বিবরণ
userStatus যাচাইকৃত Google সরকার কর্তৃক জারি করা আইডি, ক্রেডিট কার্ড, অথবা মুখের বয়স অনুমানের মতো বাণিজ্যিকভাবে যুক্তিসঙ্গত পদ্ধতি ব্যবহার করে ব্যবহারকারীর বয়স যাচাই করেছে। যদি userStatus VERIFIED হয়, তাহলে আপনি অন্যান্য ক্ষেত্রগুলি উপেক্ষা করতে পারেন।

ব্যবহারকারীর বয়সসীমা নির্ধারণ করতে ageLower এবং ageUpper ব্যবহার করুন।
ঘোষিত ব্যবহারকারীর বয়স ব্যবহারকারী, তার পিতামাতা বা আইনি অভিভাবক দ্বারা ঘোষণা করা হয়েছিল।

ব্যবহারকারীর বয়সসীমা নির্ধারণ করতে ageLower এবং ageUpper ব্যবহার করুন।
তত্ত্বাবধানে ব্যবহারকারীর একটি তত্ত্বাবধানে থাকা Google অ্যাকাউন্ট আছে যা একজন অভিভাবক দ্বারা পরিচালিত হয় যিনি তার বয়স নির্ধারণ করেন।

ব্যবহারকারীর বয়সসীমা নির্ধারণ করতে ageLower এবং ageUpper ব্যবহার করুন।

সর্বশেষ অনুমোদিত উল্লেখযোগ্য পরিবর্তনটি নির্ধারণ করতে mostRecentApprovalDate ব্যবহার করুন।
তত্ত্বাবধানে_অনুমোদিত_অপেক্ষাকৃত ব্যবহারকারীর একটি তত্ত্বাবধানে থাকা Google অ্যাকাউন্ট আছে এবং তার তত্ত্বাবধানকারী অভিভাবক এখনও এক বা একাধিক গুরুত্বপূর্ণ পরিবর্তন অনুমোদন করেননি।

ব্যবহারকারীর বয়সসীমা নির্ধারণ করতে ageLower এবং ageUpper ব্যবহার করুন।

সর্বশেষ অনুমোদিত উল্লেখযোগ্য পরিবর্তনটি নির্ধারণ করতে mostRecentApprovalDate ব্যবহার করুন।
তত্ত্বাবধানে_অনুমোদিত_অস্বীকৃত ব্যবহারকারীর একটি তত্ত্বাবধানে থাকা Google অ্যাকাউন্ট আছে এবং তার তত্ত্বাবধানকারী অভিভাবক এক বা একাধিক উল্লেখযোগ্য পরিবর্তনের অনুমোদন প্রত্যাখ্যান করেছেন।

ব্যবহারকারীর বয়সসীমা নির্ধারণ করতে ageLower এবং ageUpper ব্যবহার করুন।

সর্বশেষ অনুমোদিত উল্লেখযোগ্য পরিবর্তনটি নির্ধারণ করতে mostRecentApprovalDate ব্যবহার করুন।
অজানা
ব্যবহারকারীর বয়স অজানা এবং ব্যবহারকারী একটি প্রযোজ্য এখতিয়ার বা অঞ্চলে বাস করেন।

শুধুমাত্র মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির জন্য প্রযোজ্য: Google Play থেকে বয়সের সংকেত পেতে, ব্যবহারকারীকে তাদের স্থিতি সমাধানের জন্য Play Store-এ যেতে বলুন।
null অন্য সকল ব্যবহারকারী এই মানটি প্রদান করে। যদি userStatus null হয়, তাহলে আপনি অন্যান্য ক্ষেত্রগুলি উপেক্ষা করতে পারেন।
ageLower ০ থেকে ১৮ একজন তত্ত্বাবধানে থাকা ব্যবহারকারীর বয়সসীমার (সমেত) নিম্ন সীমা।

ব্যবহারকারীর বয়সসীমা নির্ধারণ করতে ageLower এবং ageUpper ব্যবহার করুন।
null
 userStatus অজানা অথবা null ।
ageUpper ২ থেকে ১৮ একজন তত্ত্বাবধানে থাকা ব্যবহারকারীর বয়সসীমার (সমেত) উপরের সীমা।

ব্যবহারকারীর বয়সসীমা নির্ধারণ করতে ageLower এবং ageUpper ব্যবহার করুন।
null হয় userStatus তত্ত্বাবধানে থাকে এবং ব্যবহারকারীর পিতামাতার দ্বারা প্রত্যয়িত বয়স ১৮ বছরের বেশি হয়।

অথবা userStatus অজানা অথবা null ।
mostRecentApprovalDate তারিখ স্ট্যাম্প অনুমোদিত সাম্প্রতিকতম উল্লেখযোগ্য পরিবর্তনের তারিখ effective from । যখন একটি অ্যাপ ইনস্টল করা হয়, তখন ইনস্টলের পূর্বে সাম্প্রতিকতম উল্লেখযোগ্য পরিবর্তনের তারিখ ব্যবহার করা হয়।
null হয় userStatus তত্ত্বাবধানে আছে এবং কোনও উল্লেখযোগ্য পরিবর্তন জমা দেওয়া হয়নি।

অথবা userStatus যাচাইকৃত, অজানা, অথবা null ।
installID প্লে-জেনারেটেড আলফানিউমেরিক আইডি। Google Play দ্বারা তত্ত্বাবধানে থাকা ব্যবহারকারীর ইনস্টলেশনের জন্য নির্ধারিত একটি আইডি, যা আপনাকে প্রত্যাহার করা অ্যাপ অনুমোদনের বিষয়ে অবহিত করার উদ্দেশ্যে ব্যবহৃত হয়। প্রত্যাহার করা অ্যাপ অনুমোদনের জন্য ডকুমেন্টেশন পর্যালোচনা করুন।
null userStatus যাচাইকৃত, অজানা, অথবা null ।

ব্রাজিলের ব্যবহারকারীদের জন্য উদাহরণ প্রতিক্রিয়া

ব্রাজিলে, userStatus শুধুমাত্র DECLARED এবং UNKNOWN হতে পারে।

যে ব্যবহারকারী তাদের বয়স ঘোষণা করেছেন, আপনি নিম্নলিখিতগুলি পাবেন:

  • userStatus হবে AgeSignalsVerificationStatus.DECLARED ।
  • ageLower একটি সংখ্যা হবে (উদাহরণস্বরূপ, 13)।
  • ageUpper একটি সংখ্যা বা null হবে (উদাহরণস্বরূপ, 15)।
  • অন্যান্য প্রতিক্রিয়া ক্ষেত্রগুলি null হবে।

যে ব্যবহারকারীর বয়স অজানা, আপনি নিম্নলিখিতগুলি পাবেন:

  • userStatus হবে AgeSignalsVerificationStatus.UNKNOWN ।
  • অন্যান্য প্রতিক্রিয়া ক্ষেত্রগুলি null হবে।

ব্যবহারকারীর বয়স শেয়ার করার জন্য উপলব্ধ হলে, ব্যবহারকারীর অবস্থা UNKNOWN থেকে DECLARED এ পরিবর্তিত হতে পারে।

মার্কিন যুক্তরাষ্ট্রের ব্যবহারকারীদের জন্য উদাহরণ প্রতিক্রিয়া

প্রযোজ্য মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলিতে, userStatus VERIFIED , SUPERVISED , SUPERVISED_APPROVAL_PENDING , SUPERVISED_APPROVAL_DENIED , UNKNOWN , অথবা null বলা যেতে পারে।

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

  • userStatus হবে AgeSignalsVerificationStatus.VERIFIED ।
  • ageLower একটি সংখ্যা হবে (উদাহরণস্বরূপ, 18)।
  • ageUpper একটি সংখ্যা অথবা null হবে (উদাহরণস্বরূপ, null )।
  • অন্যান্য প্রতিক্রিয়া ক্ষেত্রগুলি null হবে।

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

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

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

  • userStatus হবে AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING ।
  • ageLower একটি সংখ্যা হবে (উদাহরণস্বরূপ, 13)।
  • ageUpper একটি সংখ্যা বা null হবে (উদাহরণস্বরূপ, 15)।
  • mostRecentApprovalDate একটি জাভা তারিখ বস্তু হবে (উদাহরণস্বরূপ, 2026-01-01 ) অথবা null (যদি কোন উল্লেখযোগ্য পরিবর্তন অনুমোদিত না হয়)।
  • 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 থেকে আপনার অ্যাপটি পেতে বলুন। না
-১০ SDK_VERSION_পুরনো হয়েছে Play Age Signals SDK ভার্সনটি আর সমর্থিত নয়। ব্যবহারকারীকে আপনার অ্যাপটি পরবর্তী সংস্করণে আপডেট করতে বলুন যা Play Age Signals SDK এর সাম্প্রতিক সংস্করণ ব্যবহার করে। না
-১০০ অভ্যন্তরীণ_ত্রুটি অজানা অভ্যন্তরীণ ত্রুটি। প্রস্থানের শর্ত হিসেবে সর্বাধিক সংখ্যক প্রচেষ্টা সহ একটি পুনরায় চেষ্টা কৌশল বাস্তবায়ন করুন। যদি সমস্যাটি এখনও সমাধান না হয়, তাহলে ব্যবহারকারীকে পরে আবার চেষ্টা করতে বলুন। যদি এটি ধারাবাহিকভাবে ব্যর্থ হয়, তাহলে Google Play ডেভেলপার সহায়তার সাথে যোগাযোগ করুন , বিষয়টিতে Play Age Signals API অন্তর্ভুক্ত করুন এবং যতটা সম্ভব প্রযুক্তিগত বিবরণ অন্তর্ভুক্ত করুন (যেমন একটি বাগ রিপোর্ট)। না
পূর্ববর্তী
ওভারভিউ
পরবর্তী
উল্লেখযোগ্য পরিবর্তনগুলি অবহিত করুন