تجاوز إلى المحتوى الرئيسي
Didit تجمع 7.5 مليون دولار لبناء البنية التحتية للهوية والاحتيال
Didit
العودة إلى المدونة
المدونة · 22 نوفمبر 2026

دليل تكامل Play Age Signals API: إصدار v0.0.6 لتطبيقات Android

الاستدعاءات الثلاثة في Play Age Signals 0.0.6 بلغة Kotlin، وجدول قرارات لكل حالة ومستوى وحد، والأخطاء، والترقية من 0.0.3 و0.0.4، والاختبار، وبدء التحقق من العمر.

بواسطة Diditتحديث
play-age-signals-api-integration-cover.png

باختصار

لدمج Play Age Signals API اليوم، أضف com.google.android.play:age-signals:0.0.6، واستدعِ requestAgeSignalsAccess مع Activity، واستدعِ checkAgeSignals فقط عندما تكون الحالة SHARED.[1][2]

  • اقرأ العمر من ageLower. يوضح المستوى كيفية تحديد العمر، ولا تعني القيمة null شخصًا بالغًا على الإطلاق.
  • يعلن بيان المكتبة 0.0.6 عن minSdk 24، على الرغم من أن الدليل ينص على API 23.[1][11]
  • تبقى الإشارة داخل تطبيقك. إذا كنت بحاجة إلى التحقق من العمر بنفسك، فابدأ بذلك دون الإشارة.

تاريخ آخر مراجعة: 22 نوفمبر 2026 · لا تُعد مشورة قانونية

هذا هو الدليل الهندسي لـ Play Age Signals API: لنظام Android أولاً، ثم Flutter وReact Native وExpo وUnity. لمعرفة الفئات المتأثرة وما يبدأ في يناير 2027، اقرأ Google Play Age Signals API: ما الذي سيتغير في يناير 2027. توفر Google واجهة API ولا تلزمك باستدعائها؛ قد يلزمك القانون بذلك.

تم التحقق من كل فئة وطريقة وتعداد أدناه بمقارنتها مع صفحات Google والمكتبة المنشورة 0.0.6 في 22 نوفمبر 2026؛ ويُترجم كود Kotlin الخاص بالإشارة بنجاح عند بنائه مع هذه المكتبة.

ما تحتاجه

تعمل واجهة API على الهواتف والأجهزة القابلة للطي والأجهزة اللوحية، عبر تطبيق Play Store على الجهاز.[1][5]

  • اضبط minSdk على 24 (انظر التحذير).
  • انشر التطبيق عبر Google Play: تقصر الشروط استخدام واجهة API على التطبيقات التي تتلقى تحديثاتها عبر Google Play.[5]
  • افتح صفحة Age signals في Play Console: تتواجد هناك الأعمار المخصصة، والتغييرات الجوهرية، والموافقات الملغاة.[3][8][9]
  • أجب عن نموذج أمان البيانات في Play بنفسك. تذكر Google أن مكتبة العميل لا تجمع أي بيانات، وأن ملء النموذج هو قرارك الخاص.[5]

تنبيه

تنص صفحة الإعداد لدى Google على Android 6.0 وAPI level 23.[1] يعلن البيان داخل المكتبة 0.0.6 عن minSdkVersion 24؛ بينما أعلن الإصداران 0.0.3 و0.0.4 عن 23.[11] قد يتوقف بناء التطبيق الذي يستخدم minSdk 23 أثناء دمج البيان بعد الترقية. الحل البسيط هو رفعه إلى 24.

  1. فبراير 20260.0.3استدعاء واحد، userStatus، يضيف DECLARED.
  2. يوليو 20260.0.4استدعاءان، والمستويات تحل محل userStatus.
  3. نوفمبر 20260.0.6عالمي، ويضيف getApplicableAgeFeatures.
  4. 11 ديسمبر 2026جميع المستخدمينالموعد الذي حددته Google لتقديم استجابات لجميع المستخدمين.

إصدارات المكتبة، استنادًا إلى ملاحظات إصدار Google واللافتة التوضيحية.[2][4] حتى ذلك التاريخ، توقّع ألا يتلقى بعض المستخدمين أي استجابة.

إضافة المكتبة

تبعية واحدة.[1] توجد أداة المدير الوهمي للاختبارات في الحزمة البرمجية نفسها.[11]

dependencies {
    implementation("com.google.android.play:age-signals:0.0.6")
}

1getApplicableAgeFeatures (اختياري)

هل المشاركة إلزامية لهذا المستخدم؟

2requestAgeSignalsAccess

قد يعرض المطالبة الخاصة بـ Google Play.

الحالة هي SHARED

نعم

3checkAgeSignals

اقرأ الحدود والمصدر وحالة التغيير.

لا

لا يوجد عمر من Google

استخدم الإعداد الافتراضي المناسب للعمر لديك.

ترتيب الاستدعاء في 0.0.6.[2]

الخطوة 1: هل المشاركة إلزامية لهذا المستخدم

هذا الاستدعاء اختياري.[2] يحتوي features() على MANDATORY_SHARING فقط للمستخدمين في المناطق التي تلزم قوانينها متاجر التطبيقات بمشاركة معلومات العمر، ويكون فارغا لجميع المستخدمين الآخرين.[2]

val manager = AgeSignalsManagerFactory.create(applicationContext)

manager.getApplicableAgeFeatures(ApplicableAgeFeaturesRequest.builder().build())
    .addOnSuccessListener { result ->
        val mandatory = ApplicableAgeFeature.MANDATORY_SHARING in result.features()
        // Use it to word your own screen. It is not an age.
    }
    .addOnFailureListener { error -> handleAgeSignalsError(error) }

ملاحظة

تعني كلمة إلزامي أن مشاركة المستخدم إلزامية. ولا تشير إلى كيفية إثبات العمر: توثق Google القيمة MANDATORY_SHARING مع TIER_A وTIER_B وTIER_C وTIER_D.[3]

الخطوة 2: طلب الوصول

تكتب وثائق Google الصيغة requestAgeSignalsAccess(Activity)؛ لكن الطريقة تأخذ كائن AgeSignalsAccessRequest يحمل Activity.[2] استدعها حيث تكون المطالبة مقبولة.

val request = AgeSignalsAccessRequest.builder()
    .setActivity(this)
    .build()

manager.requestAgeSignalsAccess(request)
    .addOnSuccessListener { access ->
        when (access.ageSignalsStatus()) {
            AgeSignalsStatus.SHARED -> readSignals(manager)
            AgeSignalsStatus.NOT_SHARED -> applyGate(AgeGate.NoSignal)
            AgeSignalsStatus.VERIFICATION_REQUIRED -> applyGate(AgeGate.VerifyInPlay)
            else -> applyGate(AgeGate.NoSignal) // UNSPECIFIED or null
        }
    }
    .addOnFailureListener { error -> handleAgeSignalsError(error) }

يعتمد ما يراه المستخدم على المنطقة والإعداد:[2]

المستخدمالمطالبةالحالة
ولاية أمريكية يجب أن تقدم فيها المتاجر أعمارًا تم التحقق منها، سواء كان المستخدم موثقًا أو خاضعًا للإشرافلا شيءSHARED
الحالة نفسها، لم يتم التحقق بعدلا شيء في تطبيقك؛ يتولى Play معالجة ذلكVERIFICATION_REQUIRED
في مناطق أخرى، السؤال قبل المشاركة (الخيار الافتراضي[14])مطالبة Play داخل التطبيقSHARED أو NOT_SHARED
في مناطق أخرى، المشاركة دائمالا شيءSHARED
في مناطق أخرى، عدم المشاركة مطلقالا شيءNOT_SHARED
في مناطق أخرى، خاضع للإشرافلا شيء؛ يقرر ولي الأمر في Family LinkSHARED أو NOT_SHARED

بعد تجاهل المطالبة بضع مرات، يتوقف Play عن إظهارها، لذلك لا تستدعِها في حلقة تكرارية.[2] وحيث تكون المشاركة إلزامية، يُثبَّت الإعداد على المشاركة دائمًا.[14]

طابق بوابة العمر لديك مع الإشارة

أطلعنا على بوابتك وأسواقك، وسنوضح لك المسارات التي تتطلب فحصاً خاصاً بك وتلك التي لا تتطلبه.

اطلب عرضًا توضيحيًاابدأ مجانًا

الخطوة 3: قراءة النتيجة

كل حقل يقبل القيمة الفارغة (nullable)، لذا قم بالتحويل مرة واحدة واحتفظ بنوع واحد في تطبيقك. يقرأ هذا الربط العمر من الحدود فقط.

sealed interface AgeGate {
    data object NoSignal : AgeGate
    data object VerifyInPlay : AgeGate
    data class Range(
        val lower: Int,
        val upper: Int?,         // null = top band, not "adult"
        val source: Int?,        // AgeRangeSource.TIER_A to TIER_D
        val changeStatus: Int?   // SignificantChangeStatus
    ) : AgeGate {
        fun isAtLeast(age: Int) = lower >= age
    }
}

fun toAgeGate(r: AgeSignalsResult): AgeGate {
    val lower: Int = r.ageLower() ?: return AgeGate.NoSignal
    return AgeGate.Range(
        lower, r.ageUpper(), r.ageRangeSource(), r.significantChangeStatus()
    )
}

private fun readSignals(manager: AgeSignalsManager) {
    manager.checkAgeSignals(AgeSignalsRequest.builder().build())
        .addOnSuccessListener { result -> applyGate(toAgeGate(result)) }
        .addOnFailureListener { error -> handleAgeSignalsError(error) }
}

ثوابت الحالة والمصدر والتغيير هي أعداد صحيحة حيث 0 هو UNSPECIFIED.[10][11] تعامل معها في مسار else. أوصى دليل 0.0.3 من Google بتقديم طلب جديد عند فتح التطبيق لأن القيم تتغير[12]؛ يمكن للمستخدم أيضاً إيقاف تشغيل المشاركة لاحقاً.[14]

ملاحظة

يوصي هذا الدليل أيضاً باستدعاء Play Integrity API إلى جانب ذلك، حتى يأتي الاستدعاء من نسخة غير معدلة على جهاز معتمد.[12] الإشارة هي استجابة من جانب العميل: لا تثق في نطاق يرسله عميل معدل إلى خادمك.

جدول القرار: الحالة x المصدر x الحدود

النطاقات الافتراضية هي 0-12 و13-15 و16-17 و18+.[3] العمود الأخير هو نصيحتنا الهندسية، وليس نصيحة Google.

الحالةالمصدرالحد الأدنى / الحد الأقصىما يعنيه ذلكما يفعله رمزك البرمجي
استثناءلا يوجدلا يوجدلا توجد استجابة[7]أعد المحاولة إذا كان الخطأ قابلًا لإعادة المحاولة، ثم تعامل مع الحالة كعدم وجود إشارة
NOT_SHAREDnullnull / nullلم يوافق المستخدم أو ولي الأمر على المشاركة[2][3]الإعداد الافتراضي المناسب للعمر، دون تكرار المطالبة
VERIFICATION_REQUIREDnullnull / nullغير موثق، في منطقة يكون فيها التحقق والمشاركة إلزاميين[2][3]وجّه إلى Play Store، وأبقِ على الإعداد الافتراضي
SHAREDTIER_A13 / 15قدّم المستخدم العمر إلى Google، والتي قد تكون أكدته أو لم تؤكده[3]طبّق الفئة العمرية
SHAREDTIER_A18 / nullالأمر نفسه، فئة البالغين[3]طبّقها؛ ولا تضف فحصاً إلا إذا تطلب القانون أو تقييم المخاطر المزيد
SHAREDTIER_B13 / 15العمر مُدار من قبل أحد الوالدين أو وصي[3]طبّق الفئة العمرية، واقرأ حالة التغيير
SHAREDTIER_C18 / nullتم تقييمه عبر بطاقة ائتمان، أو بريد إلكتروني، أو صورة سيلفي، أو هوية حكومية، أو رقم تعريف ضريبي[3]طبّق الفئة العمرية
SHAREDTIER_D18 / nullهوية حكومية بالإضافة إلى صورة سيلفي، أو هوية رقمية[3]طبّق الفئة العمرية
SHAREDأيnull / أيغير وارد في جدول استجابة Googleيُعامل كعدم وجود إشارة

تتسبب ثلاث قراءات في معظم الأخطاء:

  • TIER_A لا تعني "غير موثق". البالغ الذي أجرى التحقق باستخدام هوية رقمية ولكنه يشارك باختياره يصل أيضًا ضمن TIER_A.[3] لا يتم إرجاع TIER_C وTIER_D إلا في المناطق التي يكون فيها التحقق من العمر إلزاميًا، مثل تكساس.[3] يُصنف مرجع الفئة TIER_A بأنها "معلنة ذاتيًا"؛ بينما دليل الاستجابة أكثر حذرًا.[3][10]
  • TIER_B ليست عمرا. إنها توضح من يديره. اقرأ الحدود.
  • حدود Null لا تعني بالغا تم التحقق منه. يشير تعليق في نموذج Java التابع لـ Google إلى ذلك؛ بينما يذكر نموذج Kotlin التابع لها أن المستخدم لا يشارك، ويتفق جدول الاستجابة مع نموذج Kotlin.[2][3]

متى تتوقف هنا

إذا كانت الفئة تجيب عن سؤالك ولا يتطلب أي قانون أو خطر إجراء المزيد، فتوقف. يصعب التوفيق بين إجراء فحص ثانٍ لكل مستخدم ومبدأ تقليل البيانات، وفي كاليفورنيا تعد الإشارة هي المؤشر الأساسي ما لم تكن لديك معلومات داخلية واضحة ومقنعة.[15]

عندما ينتهي مسار بعدم وجود إشارة، ستجد تصميم الخطوات التالية في ما يجب فعله عند تلقي NOT_SHARED أو TIER_A أو عدم تلقي إجابة.

الحاجة إلى إجابة عندما لا تقدم الإشارة أي نتيجة

احصل على عرض توضيحي لتقدير العمر في تطبيقك: صورة شخصية أولا، ووثيقة فقط للحالات الحدودية.

اطلب عرضًا توضيحيًاابدأ مجانًا

أعمار دنيا مخصصة

في علامة التبويب Custom age ranges، تدخل ما يصل إلى ثلاثة أعمار دنيا، بفارق سنتين على الأقل بين كل منها، وتكون قابلة للتغيير مرة واحدة سنويا. وهي تحل محل الاستجابة الافتراضية.[3]

الأعمار الدنيا المحددةالنطاقات المُرجعةالفئة العليا
لا يوجد (افتراضي)0-12, 13-15, 16-17, 18+18 / null
150-14, 15+15 / null
13, 170-12, 13-16, 17+17 / null
11, 13, 150-10, 11-12, 13-14, 15+15 / null

أمثلة من دليل استجابة Google.[3]

مثال

حددت 13 و17. سيرجع مستخدم يبلغ 25 عامًا الآن القيمة 17 / null، تمامًا مثل مستخدم يبلغ 17 عامًا. التعليمات البرمجية التي تفسر ageUpper بقيمة null على أنه بالغ تسمح لمن هم في سن 17 بالدخول إلى ميزة 18+، لذا احتفظ بـ 18 في قائمتك إذا كنت تفرض قيودًا عند سن 18. تتوقف الحدود الموثقة عند 18[3]: لا يمكن لهذه API الإجابة عن بوابة سن 21.

التغييرات الجوهرية والموافقات الملغاة

كلا الميزتين مخصصتان للمستخدمين الخاضعين للإشراف. تحديد أي قانون يجعل التغيير جوهريا هو قرارك أنت، وليس قرار Play[8]؛ قواعد الولايات مفصلة في App Store Accountability Acts.

أنت تخطر Play

تغيير جوهري

  • ما يصل إلى 3 تغييرات، قبل الموعد بما يصل إلى 90 يومًا، وبفاصل أكثر من يومين بين كل تغيير وآخر
  • الوصف باللغة الإنجليزية مطلوب، ويُعرض حرفياً للوالدين
  • قيمة significantChangeStatus هي APPROVED أو PENDING أو DECLINED
  • يجب أن يقيّد تطبيقك الميزة التي تم تغييرها

تراكمي: موافقة واحدة تغطي جميع التغييرات المعلقة[8]

يُخطرك Play

إلغاء الموافقة

  • يُحدد installId لكل مستخدم وجهاز، ولا يستمر بعد إعادة الضبط
  • يجوز لك تخزينه في خادمك الخلفي لهذا الغرض فقط
  • تظهر المعرفات الملغاة كملف CSV في Play Console
  • يُحذف كل إدخال بعد 90 يوماً، لذا بادر بالتنزيل وفق جدول زمني

يمكن أن يظهر المعرف الواحد أكثر من مرة[9]

احجب الميزة التي تم تغييرها، وليس التطبيق بأكمله، عند الحالتين PENDING وDECLINED. تكون الحالة null للحسابات غير الخاضعة للإشراف وللحسابات الخاضعة للإشراف دون أي تغيير مسجل.[3]

الأخطاء والأجهزة غير المدعومة

تصل حالات الفشل في صورة AgeSignalsException. تنصح Google بإعادة المحاولة مع الالتزام بحد أقصى لعدد المحاولات.[7]

// -8 (CLIENT_TRANSIENT_ERROR) to -1 (API_NOT_AVAILABLE) are marked retryable
private val RETRYABLE =
    AgeSignalsErrorCode.CLIENT_TRANSIENT_ERROR..AgeSignalsErrorCode.API_NOT_AVAILABLE
private var attempts = 0

fun handleAgeSignalsError(e: Exception) {
    val code = (e as? AgeSignalsException)?.errorCode
    if (code in RETRYABLE && attempts++ < 3) retryLater()
    else applyGate(AgeGate.NoSignal)
}
الرمزالثابتإعادة المحاولةالإجراء
-1, -6API_NOT_AVAILABLE, PLAY_STORE_VERSION_OUTDATEDنعمطلب تحديث Play Store
-2PLAY_STORE_NOT_FOUNDنعمطلب تثبيت Play Store أو تفعيله
-3NETWORK_ERRORنعمطلب التحقق من الاتصال
-4, -7PLAY_SERVICES_NOT_FOUND, PLAY_SERVICES_VERSION_OUTDATEDنعمطلب تثبيت Play Services أو تفعيلها أو تحديثها
-5CANNOT_BIND_TO_SERVICEنعمتراجع أسي، ثم تحديث Play Store
-8CLIENT_TRANSIENT_ERRORنعمإعادة محاولة بحد أقصى، ثم المحاولة لاحقاً
-9APP_NOT_OWNEDلالم يُثبت عبر Google Play: تثبيت جانبي أو متجر آخر
-10SDK_VERSION_OUTDATEDلاانشر إصدارًا أحدث من المكتبة
-11DEVICE_NOT_SUPPORTEDلانوع الجهاز غير مدعوم؛ جديد في 0.0.6[4]
-100INTERNAL_ERRORلالا يزال نص Google يقترح إعادة المحاولة بحد أقصى؛ الكود أعلاه لا يعيد محاولته

مرجع أكواد الأخطاء من Google.[7] الخطأ ليس عمراً: ارجع إلى التجربة الافتراضية.

الترقية من 0.0.3 و0.0.4

لا يزال الإصدار 0.0.3 يُرجع استجابات ولكنه لا يتلقى أي تحديثات.[12] الانتقال منه يتطلب إعادة كتابة مسار القراءة؛ بينما الانتقال من 0.0.4 بسيط.

في الكود الخاص بكفي 0.0.6من
checkAgeSignals بمفردهrequestAgeSignalsAccess أولاً[4]0.0.3
userStatus()تمت الإزالة: ageRangeSource() وsignificantChangeStatus()[4]0.0.3
VERIFIEDTIER_C أو TIER_D (قراءتنا)0.0.3
DECLAREDTIER_A، أو TIER_B إذا كان أحد الوالدين يديره (قراءتنا)0.0.3
SUPERVISEDTIER_B (قراءتنا)0.0.3
SUPERVISED_APPROVAL_PENDING، SUPERVISED_APPROVAL_DENIEDTIER_B مع PENDING أو DECLINED (قراءتنا)0.0.3
UNKNOWN، nullحالة الوصول: VERIFICATION_REQUIRED أو NOT_SHARED (قراءتنا)0.0.3
mostRecentApprovalDate()significantChangeApprovalDate()[4]0.0.3
استدعاءان، المستوياتدون تغيير؛ أضف getApplicableAgeFeatures إذا كان ذلك مفيداً[4]0.0.4
معالجة الأخطاءأضف DEVICE_NOT_SUPPORTED[4]كلاهما
minSdk 23المكتبة تعلن 24[11]كلاهما

لا تنشر Google أي مطابقة قيمة بقيمة. الصفوف المميزة بـ "قراءتنا" تأتي من مقارنة كلا التعريفين.[3][12]

تنبيه

لا تزال ثوابت AgeSignalsVerificationStatus القديمة مضمنة داخل 0.0.6، لذا تُترجم تعليمات الاستيراد بينما userStatus() غير موجود.[11] في 0.0.3، كانت قيمة VERIFIED هي 0؛ وفي 0.0.6، أصبحت 0 تعني UNSPECIFIED.[10][11] امسح الأعداد الصحيحة المخزنة مؤقتًا عند الترقية.

الاختبار باستخدام FakeAgeSignalsManager ومختبري التراخيص

لا يتصل FakeAgeSignalsManager بمتجر Play Store مطلقاً؛ يقتصر مرجعه على اختبارات الوحدة والتطوير المبكر.[32] قم بحقن المدير لتتمكن من تبديله.

val fake = FakeAgeSignalsManager()

// Sharing is mandatory for this user
fake.setNextApplicableAgeFeaturesResult(
    ApplicableAgeFeaturesResult.builder()
        .setFeatures(setOf(ApplicableAgeFeature.MANDATORY_SHARING))
        .build()
)
// Verification still pending in Play
fake.setNextAgeSignalsAccessResult(
    AgeSignalsAccessResult.builder()
        .setAgeSignalsStatus(AgeSignalsStatus.VERIFICATION_REQUIRED)
        .build()
)
// Supervised 13 to 15, change waiting for the parent
fake.setNextAgeSignalsResult(
    AgeSignalsResult.builder()
        .setAgeRangeSource(AgeRangeSource.TIER_B)
        .setAgeLower(13)
        .setAgeUpper(15)
        .setSignificantChangeStatus(SignificantChangeStatus.PENDING)
        .setInstallId("fake_install_id_123")
        .build()
)
// Fails checkAgeSignals
fake.setNextAgeSignalsException(
    AgeSignalsException(AgeSignalsErrorCode.NETWORK_ERROR)
)
  • قم بتغطية كل حالة، وفئة القاصرين، وفئة البالغين، والحدود الفارغة (null)، وخطأ واحد لكل استدعاء (تُسقط setNextRequestAgeSignalsAccessException وsetNextApplicableAgeFeaturesException الاستدعاءين الآخرين).
  • قم بتشغيل الاستدعاء المباشر مع مختبِر تراخيص: في العادة يحصل التطبيق الذي لم يتم تحديثه عبر Play على APP_NOT_OWNED؛ يمكن للمختبرين تثبيت إصدار تصحيح أخطاء جانبياً.[6]
  • احتفظ باسم الحزمة مطابقاً لتطبيق Play وسجل الدخول باستخدام حساب المختبِر.[6]

Flutter وReact Native وExpo وUnity

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

المنصة التقنيةالحزمة التي تم فحصهاالمكتبةتعرّف على التفاصيل قبل الإطلاق
Expoexpo-age-range 58.0.30.0.4على الويب وعلى iOS قبل 26، تُرجع lowerBound: 18، مثل البالغين[17]
React Nativereact-native-play-age-range-declaration 3.0.50.0.4تغلف أيضاً متاجر أخرى وApple[19]
Flutterage_range_signals 0.10.10.0.4مسار من استدعاءين، ودعم لمختبري التراخيص[18]
Unityunity-play-age-signals0.0.4GPL-3.0؛ قد تنفذ ردود النداء خارج الخيط الرئيسي[20]

تمت قراءتها في 22 نوفمبر 2026 من صفحة كل حزمة أو ملف بناء.[17][18][19][20] كتب فريق Unity في ديسمبر 2025 أن Unity لن تصدر ملحقًا مخصصًا.[21]

الحزمة في الإصدار 0.0.4 لا تحتوي على getApplicableAgeFeatures ولا على DEVICE_NOT_SUPPORTED. إذا كنت بحاجة إليهما، فاكتب جسراً أصلياً صغيراً. تتم مقارنة جانب Apple في Play Age Signals vs Apple Declared Age Range.

لا تقم بالتسجيل أو المشاركة أو إنشاء الملفات التعريفية

تقصر شروط Google المعلومات على التجارب المناسبة للفئة العمرية وفقًا للقوانين، داخل التطبيق الطالب.[5] وتحظر السياسة الإعلانات والتحليلات وإنشاء الملفات التعريفية، وبيع البيانات أو مشاركتها أو نقلها إلى أي طرف ثالث إلا بالقدر الذي يقتضيه القانون بصرامة.[13]

  • احتفظ بالفئات والمستويات وinstallId خارج السجلات وتقارير الأعطال وأحداث التحليلات: تنتمي هذه الأدوات عادةً إلى أطراف ثالثة.
  • احتفظ بالنتيجة الخام في الذاكرة إن أمكن، وخزّن قرار الميزة بدلًا من المستوى.
  • لا تقم أبداً بإرفاق الإشارة بمزود التحقق من العمر، بما في ذلك Didit.
  • في كاليفورنيا، لا تطلب من المستخدمين تغيير معلومات أعمارهم، ولا تشارك أي إشارة مع طرف ثالث لغرض لا يقتضيه هذا الباب.[15]
  • استشر المستشار القانوني قبل طلب إشارة لكل مستخدم: يحظر قانون كاليفورنيا الطلبات التي لا يقتضيها هو ولا أي قانون معمول به آخر.[15]

لذا فإن رسالة «قم بزيارة Play Store» تخص VERIFICATION_REQUIRED، ولا تخص مستخدمًا من كاليفورنيا تشك في فئته. تُدرج صفحة Google الإقليمية كاليفورنيا والبرازيل بوصفهما إلزاميتين اعتبارًا من يناير 2027، وتذكر ألاباما بعبارة «التفاصيل قريبًا».[16] التزامات كاليفورنيا مفصلة في دليل قانون ضمان العمر الرقمي.

بعد الإشارة: ابدأ فحصك الخاص

يحدد تطبيقك أن الفحص مطلوب؛ يحمل الطلب مسار عمل ومعرّف المستخدم الخاص بك، ولا يحمل أبداً إجابة Google. استدعِ Didit من خادمك، لأن مفتاح API يجب ألا يصل إلى الجهاز.

curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "YOUR_AGE_WORKFLOW_ID",
    "vendor_data": "user-42"
  }'

تحتوي استجابة 201 على session_id وsession_token وurl.[25] أرسل الرمز المميز فقط إلى التطبيق، ثم ابدأ SDK:[26]

// Once, in Application.onCreate: DiditSdk.initialize(this)

lifecycleScope.launch {
    DiditSdk.state.collect { state ->
        if (state is DiditSdkState.Ready) DiditSdk.launchVerificationUI(this@MainActivity)
    }
}

DiditSdk.startVerification(token = sessionToken) { result ->
    when (result) {
        is VerificationResult.Completed -> refreshAgeDecision() // asks your server
        is VerificationResult.Cancelled -> keepSafeDefault()
        is VerificationResult.Failed -> keepSafeDefault()
    }
}

نتيجة SDK مخصصة للواجهة. خذ القرار من webhook الموقع status.updated، أو اقرأ GET /v3/session/{sessionId}/decision/ من خادمك.[25][29] احتفظ بالخيار الآمن الافتراضي عند الإلغاء والفشل.

تعرّف على القيود

حيثما تكون الإشارة كافية، تخطَّ هذه الخطوة. لا يكون الفحص الخاص أفضل دائمًا. يستخدم قانونا ألاباما ويوتا، اللذان يفرضان واجبات اعتبارًا من 2027، أدنى فئة عمرية للحمايات التي يغطيانها، وتستخدم البرازيل البديل الأكثر حماية، لذا لا يمكن للفحص هناك إلا أن يشدّد القيود.[22][23][24] يحتاج الأشخاص الذين يشملهم قانون إلينوي أو تكساس أو كولورادو إلى خطوة الموافقة البيومترية قبل التقاط الصورة الذاتية، ويمكن لـ SDK الأصلي 4.10.0 أو الأحدث عرضها.[28] تحقق مع المستشار القانوني لتحديد القاعدة التي تنطبق على تطبيقك.

كيف تساعد Didit بعد الإشارة

تقدّر أداة Didit Age Estimation العمر من صورة شخصية (selfie)، مع التحقق من الحيوية (liveness) في الخطوة نفسها، دون تحديد هوية الشخص. ويمكن لمسار العمل توجيه الفئة الحدودية التي تحددها إلى خطوة التحقق من المستند.[27] تبلغ تكلفة Age Estimation مبلغ $0.10 لكل استدعاء؛ راجع الأسعار.

Didit console, age estimation result of a verification: the estimated age from the selfie next to the age on the document

نتيجة تقدير العمر في لوحة تحكم Didit (بيانات تجريبية): التقدير من الصورة الشخصية بجانب العمر في المستند.

تتوفر حزم SDK أصلية لأنظمة Android وiOS وReact Native وFlutter. بالنسبة لمحرك Unity والمحركات الأخرى، فإن المسار الموثق هو التكامل عبر WebView.[31] يتم تغطية البيئات خارج Google Play في واجهة API للتحقق من العمر: التطبيقات والويب والمتاجر وعلى صفحة حلول التحقق من العمر.

ما تقدمه Didit

  • فحص عمر مستضاف يتضمن صورة شخصية وفحص الحيوية وخطوة مستندات اختيارية
  • خيار مسار عمل متوافق مع ISO/IEC 27566-1 يعيد قرارا بنعم أو لا بشأن العمر ودون بيانات شخصية، بدءا من سن أدنى يبلغ 13 عاما[27]
  • فترات احتفاظ بالبيانات، ومفاتيح تبديل للبيانات المسترجعة، واستدعاء للحذف[30]

ما يبقى تحت إدارتك

  • استدعاء Play Age Signals ونتيجته
  • القانون الواجب التطبيق وما إذا كان الفحص مطلوبا أصلا
  • الإعداد الافتراضي المناسب للعمر وقرار الوصول النهائي

لا توفر Didit موصلا لخدمة Play Age Signals: تظل الإشارة داخل تطبيقك.

شاهد مسار الرجوع البديل يعمل داخل تطبيقك

استخدم بوابة العمر الخاصة بك وأسواقك وبنيتك التقنية، أو قم ببناء مسار العمل بنفسك.

اطلب عرضًا توضيحيًاابدأ مجانًااقرأ الوثائق

النقاط الرئيسية

  • استخدم الإصدار 0.0.6: استدعاء ميزات اختياري، طلب وصول، ثم checkAgeSignals فقط عند الحصول على SHARED.
  • قم بالتقييد بناءً على ageLower؛ تعني القيمة null في ageUpper الفئة العليا، ويمكن للأعمار المخصصة خفضها إلى أقل من 18 عامًا.
  • الحدود الفارغة (null)، والقيمة UNSPECIFIED، والأخطاء تعني عدم وجود إشارة، ولا تعني بالغا أبدا.
  • يحدد بيان الإصدار 0.0.6 الحد الأدنى minSdk 24.
  • احتفظ بالإشارة داخل تطبيقك وابدأ أي فحص خاص بك بدونها.

الأسئلة الشائعة

أي إصدار من Play Age Signals API يجب أن أستخدم؟

استخدم 0.0.6. إنه الإصدار الحالي والمتاح عالميًا، وتقول Google إنه سيعيد استجابات لجميع المستخدمين بحلول 11 ديسمبر 2026؛ في هذه الأثناء يستمر 0.0.4 في إعادة الاستجابات في مناطق محددة.[2]

هل أحتاج إلى استدعاء getApplicableAgeFeatures؟

لا، تصنفها Google على أنها اختيارية. استدعِه عندما يجب أن تختلف شاشاتك لمستخدم تكون المشاركة لديه إلزامية.[2]

ما الفرق بين NOT_SHARED وVERIFICATION_REQUIRED؟

تعني NOT_SHARED أن تطبيقك لا يتلقى أي إشارة عمر لأن المستخدم أو ولي الأمر لم يوافق على المشاركة. وتعني VERIFICATION_REQUIRED أن العمر لم يتم التحقق منه في منطقة تكون فيها كل من عمليات التحقق والمشاركة إلزامية، وتوجهك Google إلى مطالبة المستخدم بزيارة Play Store.[2]

لماذا يكون الحدان فارغين (null)؟

يعطي مرجع الاستجابة حدوداً بقيمة null عندما تكون الحالة NOT_SHARED أو VERIFICATION_REQUIRED.[3] تعامل مع حدود null على أنها عدم وجود إشارة، ولا تعتبرها إشارة لشخص بالغ أبداً.

لماذا تكون ageUpper بقيمة null للبالغين؟

لأن الفئة العليا مفتوحة النهاية: تُرجع فئة 18+ القيمة 18 في ageLower وقيمة null في ageUpper.[3] ومع الأعمار المخصصة، يمكن أن تبدأ الفئة العليا من سن أصغر، لذا قارن ageLower بالحد الأدنى للسن المعتمد لديك.

هل يمكنني تحديد نطاقات عمرية مخصصة؟

نعم، ما يصل إلى ثلاثة أعمار دنيا في صفحة Age signals في Play Console، بفارق عامين على الأقل بين كل منها، وقابلة للتغيير مرة واحدة سنويًا. وهي تحل محل النطاقات الافتراضية.[3]

كيف أختبر التطبيق قبل سريان القانون؟

استخدم FakeAgeSignalsManager لإرجاع أي حالة أو نطاق أو خطأ، بما في ذلك MANDATORY_SHARING. يتيح حساب مختبِر تراخيص لنسخة تصحيح أخطاء مثبتة جانبيًا استدعاء API الفعلي.[6]

هل تعمل في Trusted Web Activity أو WebView؟

ليس من كود الويب. إنها مكتبة Android تُستدعى مع Activity، وصفحات Google التي اطلعنا عليها لا توثق أي واجهة ويب. سيحتاج التطبيق الحاوي إلى كود أصلي خاص به، وشروط Google تقصر المعلومات على التطبيق الطالب فقط.[2][5]

هل يتوفر ملحق لـ Unity أو Flutter أو React Native؟

توجد حزم من المجتمع وأطر العمل. الحزم التي فحصناها في 22 نوفمبر 2026 تعلن عن الإصدار 0.0.4، لذا فهي تفتقر إلى getApplicableAgeFeatures. أفاد مسؤولو Unity في ديسمبر 2025 بأن Unity لن تصدر ملحقاً مخصصاً.[17][18][19][20][21]

هل يمكنني تخزين النتيجة على خادمي؟

تصف صفحات Google صراحة تخزين installId على خادمك الخلفي لإشعارات الإلغاء. أما بالنسبة للباقي، فاحتفظ بالحد الأدنى من النتيجة الذي يقتضيه واجبك القانوني، داخل أنظمتك الخاصة، ولا تحتفظ بها أبدًا في التحليلات أو الإعلانات أو لدى خدمات طرف ثالث ما لم يتطلب القانون ذلك بصرامة.[9][13]

المصادر

  1. Use Play Age Signals API (beta)، Android Developers، تم التحديث في 19 نوفمبر 2026.
  2. Request age signals، Android Developers، تم التحديث في 18 نوفمبر 2026.
  3. Understand age signals responses، Android Developers، تم التحديث في 18 نوفمبر 2026.
  4. Play Age Signals release notes، Android Developers، تم التحديث في 19 نوفمبر 2026.
  5. Play Age Signals overview and terms of service، Android Developers، تم التحديث في 18 نوفمبر 2026.
  6. Test your Play Age Signals API (beta) integration، Android Developers، تم التحديث في 19 نوفمبر 2026.
  7. Play Age Signals API error code reference، Android Developers، تم التحديث في 18 نوفمبر 2026.
  8. Notify Google Play of significant changes، Android Developers، تم التحديث في 4 سبتمبر 2026.
  9. Review revoked app approvals، Android Developers، تم التحديث في 4 سبتمبر 2026.
  10. AgeRangeSource reference، Android Developers، تم التحديث في 18 نوفمبر 2026.
  11. com.google.android.play:age-signals، Google Maven؛ بيانات المكتبة وفئاتها للإصدارات 0.0.3 و0.0.4 و0.0.6 تمت مراجعتها في 22 نوفمبر 2026.
  12. Use Play Age Signals API, version 0.0.3، Android Developers، تم التحديث في 23 أكتوبر 2026.
  13. Age Signals API and User Data policy، مساعدة Google Play Console.
  14. About age range sharing on Google Play، مساعدة Google Play.
  15. AB 1856, Chapter 184, Statutes of 2026، California Legislative Information؛ يعدل Civil Code من 1798.500 إلى 1798.504.
  16. Regional age-related protections on Play، Android Developers، تم التحديث في 18 نوفمبر 2026.
  17. Expo AgeRange، وثائق Expo؛ الحزمة expo-age-range 58.0.3.
  18. age_range_signals، pub.dev، الإصدار 0.10.1 بتاريخ 6 أكتوبر 2026.
  19. react-native-play-age-range-declaration، GitHub، الإصدار 3.0.5.
  20. unity-play-age-signals، GitHub، تم التحديث في 4 أغسطس 2026.
  21. Play Age Signals API Support, Unity Discussions، رد موظفي Unity في ديسمبر 2025.
  22. Code of Alabama 8-19K-9 (HB 161)، الهيئة التشريعية في Alabama.
  23. Utah Code 13-76-202، الهيئة التشريعية في Utah؛ التزامات المطورين اعتباراً من 6 مايو 2027.
  24. Decreto 12.880 بتاريخ 18 مارس 2026، المادة 25، Planalto، البرازيل.
  25. إنشاء جلسة، وثائق Didit.
  26. Android SDK، وثائق Didit.
  27. نظرة عامة على تقدير العمر، وثائق Didit.
  28. الموافقة البيومترية، وثائق Didit.
  29. Webhooks، وثائق Didit.
  30. الاحتفاظ بالبيانات، وثائق Didit.
  31. نظرة عامة على Native SDKs، وثائق Didit.
  32. مرجع FakeAgeSignalsManager، مطورو Android، تم التحديث في 18 نوفمبر 2026.

انشر الاستدعاءات الثلاثة، واختبر كل صف في الجدول، واحتفظ بالإشارة حيث تتركها شروط Google: داخل تطبيقك. وبالنسبة إلى المسارات التي لا تستطيع الإشارة الإجابة عنها، أضف تقدير العمر كإجراء تحقق خاص بك.

أضف التحقق للمستخدمين الذين لا يملكون إشارة

احجز عرضاً توضيحياً لتقدير العمر في تطبيقك، أو أنشئ مسار عمل وابدأ جلسة اليوم.

اطلب عرضًا توضيحيًاابدأ مجانًا

بنية تحتية للهوية والاحتيال.

واجهة برمجية واحدة لـ KYC و KYB ومراقبة المعاملات وفحص المحافظ. ادمجها في 5 دقائق.

اطلب من الذكاء الاصطناعي تلخيص هذه الصفحة