استخدام واجهة برمجة التطبيقات Play Age Signals API (إصدار تجريبي)

باستخدام واجهة برمجة التطبيقات Play Age Signals API (الإصدار التجريبي)، أنت توافق على بنود الخدمة وتوافق على الالتزام بجميع سياسات المطوّرين على Google Play. لطلب حالة المستخدم والفئة العمرية، عليك إرسال طلب إلى واجهة برمجة التطبيقات من تطبيقك في وقت التشغيل. لا تعرض واجهة برمجة التطبيقات Play Age Signals API سوى بيانات المستخدمين المقيمين في المناطق التي يفرض القانون فيها على Play تقديم بيانات الفئة العمرية.

تعرض Play فئة عمرية استنادًا إلى الفئات العمرية المحدّدة حسب الاختصاص القضائي والمناطق السارية. تتراوح الأعمار التلقائية التي تعرضها واجهة برمجة التطبيقات في الولايات القضائية والمناطق السارية بين 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 تلقائيًا إشارات العمر المخزّنة مؤقتًا لهذا المستخدم خلال مدة تتراوح بين أسبوعَين و8 أسابيع بعد تاريخ ميلاده.

(اختياري) تلقّي فئات عمرية مخصّصة

تتضمّن الفئات العمرية التلقائية التي تعرضها واجهة برمجة التطبيقات في الولايات القضائية والمناطق السارية 0-12 و13-15 و16-17 و18 عامًا فأكثر، وقد تتغيّر هذه الفئات في المستقبل استنادًا إلى المتطلبات المحلية.

بدلاً من ذلك، لتخصيص الفئات العمرية وفقًا للحدّ الأدنى للعمر في تطبيقك، يمكنك تقديم هذه الفئات العمرية في صفحة إشارات العمر في Google Play Console. تعرض واجهة Age Signals API الفئات العمرية المخصّصة. على سبيل المثال، إذا قدّمت الحد الأدنى للأعمار 9 و15 و17 عامًا، سيقع المستخدم البالغ من العمر 14 عامًا ضمن الفئة العمرية من 10 إلى 15 عامًا. يجب ألا يقل الفارق العمري عن سنتَين ويمكن تغييره مرة واحدة سنويًا.

لتخصيص الفئات العمرية التي تعرضها واجهة Age Signals API، يمكنك تحديد الحدّ الأدنى للعمر في تطبيقك باتّباع الخطوات التالية:

1. انتقِل إلى صفحة إشارات العمر في حسابك على Play Console.
2. في علامة التبويب الحدّ الأدنى للعمر المسموح به لاستخدام التطبيق، أدخِل ما يصل إلى ثلاث فئات عمرية ضمن الحدّ الأدنى للعمر المسموح به لاستخدام تطبيقك.
3. انقر على حفظ.

الردود المستندة إلى مؤشرات الفئات العمرية

يتضمّن الردّ من واجهة برمجة التطبيقات Play Age Signals API (إصدار تجريبي) الحقول والقيم التالية. وقد تتغيّر القيم. إذا كنت تريد الحصول على أحدث القيم، اطلب الحصول على ردّ من واجهة برمجة التطبيقات عند فتح تطبيقك. أنت المسؤول عن تقديم تجارب مناسبة للفئة العمرية باستخدام هذه الإشارات.

التعامل مع رموز الأخطاء في واجهة برمجة التطبيقات

إذا أرسل تطبيقك طلبًا إلى واجهة برمجة التطبيقات Play Age Signals API (إصدار تجريبي) وتعذّر إكمال الطلب، سيتلقّى تطبيقك رمز خطأ. ويمكن أن تحدث هذه الأخطاء لأسباب مختلفة، مثل أنّ تطبيق "متجر Play" قديم.

استراتيجية إعادة المحاولة

في الحالات التي يكون فيها المستخدم في جلسة، ننصحك بتنفيذ استراتيجية إعادة المحاولة مع تحديد الحد الأقصى لعدد المحاولات كشرط للخروج، وذلك حتى لا يؤدي الخطأ إلى تعطيل تجربة المستخدم قدر الإمكان.