Lewati ke konten utama
Didit Raih $7,5 Juta untuk Membangun Infrastruktur Identitas dan Fraud
Didit
Kembali ke blog
Blog · 22 November 2026

Panduan integrasi Play Age Signals API: v0.0.6 untuk aplikasi Android

Tiga panggilan Play Age Signals 0.0.6 di Kotlin, tabel keputusan untuk setiap status, tier dan batas, eror, migrasi dari 0.0.3 dan 0.0.4, pengujian, serta cara memulai pemeriksaan usia Anda sendiri.

Oleh DiditDiperbarui
play-age-signals-api-integration-cover.png

Singkatnya

Untuk mengintegrasikan Play Age Signals API hari ini, tambahkan com.google.android.play:age-signals:0.0.6, panggil requestAgeSignalsAccess dengan Activity, dan panggil checkAgeSignals hanya ketika statusnya adalah SHARED.[1][2]

  • Baca usia dari ageLower. Tier menunjukkan cara usia ditetapkan, dan null tidak pernah berarti dewasa.
  • Manifest pustaka 0.0.6 menyatakan minSdk 24, meskipun panduan menyebutkan API 23.[1][11]
  • Sinyal tetap berada di aplikasi Anda. Jika Anda memerlukan pemeriksaan usia sendiri, mulai tanpa sinyal tersebut.

Terakhir ditinjau: 22 November 2026 · Bukan nasihat hukum

Ini adalah panduan teknis untuk Play Age Signals API: Android terlebih dahulu, lalu Flutter, React Native, Expo, dan Unity. Untuk mengetahui siapa yang terpengaruh dan apa yang dimulai pada Januari 2027, baca Google Play Age Signals API: apa yang berubah pada Januari 2027. Google menyediakan API ini dan tidak mewajibkan Anda untuk memanggilnya; undang-undang mungkin mewajibkannya.

Setiap kelas, metode, dan enum di bawah ini telah diperiksa berdasarkan halaman Google dan pustaka 0.0.6 yang dipublikasikan pada 22 November 2026; kode Kotlin untuk sinyal berhasil dikompilasi terhadap pustaka tersebut.

Yang Anda butuhkan

API berjalan di ponsel, perangkat lipat, dan tablet, melalui aplikasi Play Store di perangkat.[1][5]

  • Atur minSdk ke 24 (lihat peringatan).
  • Distribusikan melalui Google Play: ketentuan membatasi API hanya untuk aplikasi yang diperbarui oleh Google Play.[5]
  • Buka halaman Age signals di Play Console: usia kustom, perubahan signifikan, dan persetujuan yang dicabut berada di sana.[3][8][9]
  • Isi sendiri formulir keamanan data Play. Google menyatakan pustaka klien tidak mengumpulkan data dan pengisian formulir adalah keputusan Anda.[5]

Perhatian

Halaman penyiapan Google menyebutkan Android 6.0, API level 23.[1] Manifest di dalam pustaka 0.0.6 menyatakan minSdkVersion 24; 0.0.3 dan 0.0.4 menyatakan 23.[11] Aplikasi dengan minSdk 23 dapat gagal dibangun saat penggabungan manifest setelah peningkatan versi. Menaikkannya ke 24 adalah perbaikan paling sederhana.

  1. Februari 20260.0.3Satu panggilan, userStatus, menambahkan DECLARED.
  2. Juli 20260.0.4Dua panggilan, tier menggantikan userStatus.
  3. November 20260.0.6Global, menambahkan getApplicableAgeFeatures.
  4. 11 Desember 2026Semua penggunaTanggal yang ditetapkan Google untuk respons kepada semua pengguna.

Versi pustaka, dari catatan rilis dan banner Google.[2][4] Sampai tanggal itu, perkirakan ada pengguna yang belum menerima respons.

Tambahkan pustaka

Satu dependensi.[1] Manager palsu untuk pengujian ada di dalam artefak yang sama.[11]

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

1getApplicableAgeFeatures (opsional)

Apakah pembagian wajib bagi pengguna ini.

2requestAgeSignalsAccess

Dapat menampilkan dialog milik Google Play sendiri.

Status adalah SHARED

Ya

3checkAgeSignals

Baca batas, sumber, status perubahan.

Tidak

Tidak ada usia dari Google

Gunakan default Anda yang sesuai dengan usia.

Urutan pemanggilan di 0.0.6.[2]

Langkah 1: apakah pembagian bersifat wajib untuk pengguna ini

Pemanggilan ini bersifat opsional.[2] features() berisi MANDATORY_SHARING hanya untuk pengguna di wilayah yang undang-undangnya mewajibkan toko aplikasi untuk membagikan informasi usia, dan kosong untuk pengguna lainnya.[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) }

Catatan

Wajib berarti pembagian oleh pengguna bersifat wajib. Hal ini tidak menyatakan apa pun tentang bagaimana usia ditetapkan: Google mendokumentasikan MANDATORY_SHARING dengan TIER_A, TIER_B, TIER_C, dan TIER_D.[3]

Langkah 2: minta akses

Teks Google menuliskan requestAgeSignalsAccess(Activity); metode ini menerima AgeSignalsAccessRequest yang membawa Activity.[2] Panggil metode ini di tempat yang memungkinkan munculnya dialog.

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) }

Apa yang dilihat pengguna bergantung pada wilayah dan pengaturan:[2]

PenggunaDialogStatus
Negara bagian AS tempat toko wajib memberikan usia terverifikasi (pengguna terverifikasi atau diawasi)Tidak adaSHARED
Sama, belum diverifikasiTidak ada di aplikasi Anda; Play menanganinyaVERIFICATION_REQUIRED
Di tempat lain, Tanya sebelum membagikan (default[14])Dialog dalam aplikasi milik PlaySHARED atau NOT_SHARED
Di tempat lain, Selalu bagikanTidak adaSHARED
Di tempat lain, Jangan pernah bagikanTidak adaNOT_SHARED
Di tempat lain, diawasiTidak ada; orang tua memutuskan di Family LinkSHARED atau NOT_SHARED

Setelah beberapa kali ditutup, Play berhenti menampilkan dialog, jadi jangan memanggilnya dalam perulangan.[2] Jika pembagian bersifat wajib, pengaturannya ditetapkan ke Selalu bagikan.[14]

Petakan gerbang usia (age gate) Anda ke sinyal tersebut

Tunjukkan gerbang usia dan pasar Anda kepada kami, dan kami akan menunjukkan cabang mana yang memerlukan pemeriksaan Anda sendiri dan mana yang tidak.

Dapatkan demoMulai gratis

Langkah 3: baca hasilnya

Setiap kolom dapat bernilai null, jadi konversikan sekali dan pertahankan satu tipe di aplikasi Anda. Pemetaan ini membaca usia dari nilai batas saja.

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) }
}

Konstanta status, sumber, dan perubahan berupa bilangan bulat, dengan 0 sebagai UNSPECIFIED.[10][11] Tangani nilai ini dalam cabang else. Panduan 0.0.3 dari Google menyarankan permintaan baru saat aplikasi dibuka karena nilai dapat berubah[12]; pengguna juga dapat mematikan pembagian di kemudian hari.[14]

Catatan

Panduan tersebut juga menyarankan pemanggilan Play Integrity API secara bersamaan, agar panggilan berasal dari build yang tidak dimodifikasi pada perangkat bersertifikasi.[12] Sinyal ini merupakan respons sisi klien: jangan memercayai rentang yang dikirim oleh klien yang dimodifikasi ke server Anda.

Tabel keputusan: status x sumber x batas

Rentang default adalah 0-12, 13-15, 16-17, dan 18+.[3] Kolom terakhir adalah saran teknis kami, bukan saran Google.

StatusSumberBawah / atasArtiTindakan kode Anda
Eksepsitidak adatidak adaTidak ada respons[7]Coba lagi jika dapat diulang, lalu anggap tidak ada sinyal
NOT_SHAREDnullnull / nullPengguna atau orang tua tidak setuju untuk membagikan[2][3]Gunakan default yang sesuai usia, jangan tampilkan dialog lagi
VERIFICATION_REQUIREDnullnull / nullBelum diverifikasi, di wilayah tempat verifikasi dan pembagian bersifat wajib[2][3]Arahkan ke Play Store, pertahankan default
SHAREDTIER_A13 / 15Pengguna memberikan usia kepada Google, yang mungkin telah atau belum mengonfirmasinya[3]Terapkan rentang tersebut
SHAREDTIER_A18 / nullSama, rentang dewasa[3]Terapkan; tambahkan pemeriksaan hanya jika hukum atau risiko menuntut lebih
SHAREDTIER_B13 / 15Usia dikelola oleh orang tua atau wali[3]Terapkan rentang tersebut, baca status perubahannya
SHAREDTIER_C18 / nullDinilai melalui kartu kredit, email, selfie, kartu identitas pemerintah, atau ID pajak[3]Terapkan rentang tersebut
SHAREDTIER_D18 / nullKartu identitas pemerintah ditambah selfie, atau identitas digital[3]Terapkan rentang tersebut
SHAREDapa punnull / apa punTidak ada dalam tabel respons GooglePerlakukan sebagai tidak ada sinyal

Tiga penafsiran menyebabkan sebagian besar kesalahan:

  • TIER_A bukan "tidak terverifikasi". Orang dewasa yang memverifikasi dengan ID digital tetapi memilih untuk membagikan juga diterima sebagai TIER_A.[3] TIER_C dan TIER_D hanya dikembalikan di wilayah tempat verifikasi usia diwajibkan, misalnya Texas.[3] Referensi kelas melabeli TIER_A sebagai "dideklarasikan sendiri"; panduan respons lebih berhati-hati.[3][10]
  • TIER_B bukan usia. Nilai ini menyatakan siapa yang mengelolanya. Baca batas rentangnya.
  • Batas bernilai null bukan orang dewasa terverifikasi. Sebuah komentar dalam contoh Java Google menyiratkan hal tersebut; contoh Kotlin-nya menyatakan pengguna tidak membagikan, dan tabel respons sejalan dengan Kotlin.[2][3]

Kapan harus berhenti di sini

Jika rentang usia menjawab pertanyaan Anda dan tidak ada hukum atau risiko yang meminta lebih banyak, berhentilah. Pemeriksaan kedua pada setiap pengguna sulit diselaraskan dengan minimisasi data, dan di California sinyal tersebut adalah indikator utama kecuali Anda memiliki informasi internal yang jelas dan meyakinkan.[15]

Jika sebuah percabangan berakhir tanpa sinyal, rancangan langkah berikutnya ada di hal yang harus dilakukan pada NOT_SHARED, TIER_A, atau tanpa jawaban.

Butuh jawaban ketika sinyal tidak memilikinya

Dapatkan demo estimasi usia di aplikasi Anda: swafoto terlebih dahulu, dokumen hanya untuk kasus batas.

Dapatkan demoMulai gratis

Usia minimum kustom

Pada tab Custom age ranges, Anda memasukkan hingga tiga usia minimum, dengan selisih setidaknya dua tahun, dapat diubah setahun sekali. Nilai-nilai ini menggantikan respons default.[3]

Usia minimum yang ditetapkanRentang yang dikembalikanRentang teratas
Tidak ada (default)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

Contoh dari panduan respons Google.[3]

Contoh

Anda menetapkan 13 dan 17. Pengguna berusia 25 tahun kini mengembalikan 17 / null, sama seperti pengguna berusia 17 tahun. Kode yang membaca ageUpper bernilai null sebagai dewasa akan meloloskan pengguna berusia 17 tahun ke fitur 18+, jadi tetap sertakan 18 dalam daftar Anda jika Anda membatasi akses pada usia 18. Batas yang terdokumentasi berhenti pada 18[3]: API ini tidak dapat menjawab pembatasan akses untuk usia 21.

Perubahan signifikan dan persetujuan yang dicabut

Kedua fitur tersebut ditujukan untuk pengguna yang diawasi. Hukum mana yang menjadikan suatu perubahan signifikan adalah keputusan Anda, bukan keputusan Play[8]; aturan negara bagian ada di App Store Accountability Acts.

Anda memberi tahu Play

Perubahan signifikan

  • Hingga 3 perubahan, hingga 90 hari sebelumnya, berjarak lebih dari 2 hari
  • Deskripsi bahasa Inggris diwajibkan, ditampilkan kata demi kata kepada orang tua
  • significantChangeStatus bernilai APPROVED, PENDING, atau DECLINED
  • Aplikasi Anda harus membatasi fitur yang diubah

Kumulatif: satu persetujuan mencakup semua perubahan yang tertunda[8]

Play memberi tahu Anda

Persetujuan yang dicabut

  • installId berlaku per pengguna dan perangkat, serta tidak bertahan setelah reset
  • Anda boleh menyimpannya di backend Anda hanya untuk tujuan ini
  • ID yang dicabut muncul sebagai CSV di Play Console
  • Setiap entri dihapus setelah 90 hari, jadi unduh secara berkala

Satu ID dapat muncul lebih dari satu kali[9]

Batasi fitur yang diubah, bukan seluruh aplikasi, pada status PENDING dan DECLINED. Status bernilai null untuk akun tanpa pengawasan dan akun yang diawasi tanpa perubahan tercatat.[3]

Kesalahan dan perangkat yang tidak didukung

Kegagalan diterima sebagai AgeSignalsException. Google menyarankan percobaan ulang dengan jumlah upaya maksimum.[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)
}
KodeKonstantaCoba lagiTindakan
-1, -6API_NOT_AVAILABLE, PLAY_STORE_VERSION_OUTDATEDYaMinta untuk memperbarui Play Store
-2PLAY_STORE_NOT_FOUNDYaMinta untuk menginstal atau mengaktifkan Play Store
-3NETWORK_ERRORYaMinta untuk memeriksa koneksi
-4, -7PLAY_SERVICES_NOT_FOUND, PLAY_SERVICES_VERSION_OUTDATEDYaMinta untuk menginstal, mengaktifkan, atau memperbarui Play Services
-5CANNOT_BIND_TO_SERVICEYaBackoff eksponensial, lalu perbarui Play Store
-8CLIENT_TRANSIENT_ERRORYaPercobaan ulang terbatas, lalu coba lagi nanti
-9APP_NOT_OWNEDTidakTidak diinstal oleh Google Play: sideload atau toko lain
-10SDK_VERSION_OUTDATEDTidakRilis pustaka yang lebih baru
-11DEVICE_NOT_SUPPORTEDTidakJenis perangkat tidak dilayani; baru di 0.0.6[4]
-100INTERNAL_ERRORTidakTeks Google masih menyarankan percobaan ulang terbatas; kode di atas tidak mengulanginya

Referensi kode kesalahan Google.[7] Kesalahan bukanlah usia: beralih ke pengalaman default.

Migrasi dari 0.0.3 dan 0.0.4

Versi 0.0.3 masih mengembalikan respons tetapi tidak menerima pembaruan.[12] Migrasi darinya memerlukan penulisan ulang jalur pembacaan (read path); dari 0.0.4 perubahannya kecil.

Di kode AndaDi 0.0.6Dari
Hanya checkAgeSignalsrequestAgeSignalsAccess terlebih dahulu[4]0.0.3
userStatus()Dihapus: ageRangeSource() dan significantChangeStatus()[4]0.0.3
VERIFIEDTIER_C atau TIER_D (penafsiran kami)0.0.3
DECLAREDTIER_A, atau TIER_B jika dikelola oleh orang tua (penafsiran kami)0.0.3
SUPERVISEDTIER_B (penafsiran kami)0.0.3
SUPERVISED_APPROVAL_PENDING, SUPERVISED_APPROVAL_DENIEDTIER_B dengan PENDING atau DECLINED (penafsiran kami)0.0.3
UNKNOWN, nullStatus akses: VERIFICATION_REQUIRED atau NOT_SHARED (penafsiran kami)0.0.3
mostRecentApprovalDate()significantChangeApprovalDate()[4]0.0.3
Dua panggilan, tierTidak berubah; tambahkan getApplicableAgeFeatures jika berguna[4]0.0.4
Penanganan kesalahanTambahkan DEVICE_NOT_SUPPORTED[4]Keduanya
minSdk 23Pustaka mendeklarasikan 24[11]Keduanya

Google tidak memublikasikan pemetaan nilai per nilai. Baris yang ditandai "penafsiran kami" berasal dari perbandingan kedua definisi tersebut.[3][12]

Perhatian

Konstanta AgeSignalsVerificationStatus lama masih disertakan di dalam 0.0.6, sehingga import dapat dikompilasi meskipun userStatus() tidak ada.[11] Pada 0.0.3, VERIFIED bernilai 0; pada 0.0.6, 0 adalah UNSPECIFIED.[10][11] Hapus nilai integer yang di-cache saat Anda meningkatkan versi.

Uji dengan FakeAgeSignalsManager dan penguji lisensi

FakeAgeSignalsManager tidak pernah berkomunikasi dengan Play Store; referensinya membatasi penggunaannya hanya untuk pengujian unit dan pengembangan awal.[32] Suntikkan manager tersebut agar Anda dapat menukarnya.

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)
)
  • Cakup setiap status, rentang usia anak, rentang usia dewasa, batas null, dan satu kesalahan per panggilan (setNextRequestAgeSignalsAccessException dan setNextApplicableAgeFeaturesException menggagalkan dua panggilan lainnya).
  • Jalankan panggilan langsung dengan penguji lisensi: biasanya aplikasi yang tidak diperbarui oleh Play akan menerima APP_NOT_OWNED; penguji dapat memasang build debug secara sideload.[6]
  • Pastikan nama paket identik dengan aplikasi Play dan masuk menggunakan akun penguji.[6]

Flutter, React Native, Expo, dan Unity

Ini adalah paket komunitas atau framework, bukan dari Google, dan mencantumkannya bukan merupakan rekomendasi. Periksa versi pustaka sebelum Anda merilisnya.

StackPaket yang diperiksaPustakaKetahui sebelum Anda merilis
Expoexpo-age-range 58.0.30.0.4Pada web dan pada iOS sebelum 26, ini mengembalikan lowerBound: 18, seperti orang dewasa[17]
React Nativereact-native-play-age-range-declaration 3.0.50.0.4Juga membungkus toko lain dan Apple[19]
Flutterage_range_signals 0.10.10.0.4Alur dua panggilan, dukungan penguji lisensi[18]
Unityunity-play-age-signals0.0.4GPL-3.0; callback dapat berjalan di luar main thread[20]

Dibaca pada 22 November 2026 dari setiap halaman paket atau berkas build.[17][18][19][20] Staf Unity menulis pada Desember 2025 bahwa Unity tidak akan merilis plugin khusus.[21]

Paket pada versi 0.0.4 tidak memiliki getApplicableAgeFeatures dan tidak memiliki DEVICE_NOT_SUPPORTED. Jika Anda membutuhkannya, buat jembatan native kecil. Sisi Apple dibandingkan dalam Play Age Signals vs Apple Declared Age Range.

Jangan mencatat, membagikan, atau memprofilkan

Persyaratan Google membatasi informasi tersebut hanya untuk pengalaman yang sesuai usia demi kepatuhan terhadap hukum, di dalam aplikasi yang meminta.[5] Kebijakan ini melarang periklanan, analitik, pembuatan profil, serta penjualan, pembagian, atau pengalihan data ke pihak ketiga mana pun kecuali jika diwajibkan secara ketat oleh hukum.[13]

  • Jauhkan rentang, tier, dan installId dari log, laporan crash, dan event analitik: alat-alat tersebut biasanya milik pihak ketiga.
  • Simpan hasil mentah di memori jika memungkinkan, dan simpan keputusan fitur alih-alih tier.
  • Jangan pernah mengirimkan sinyal tersebut ke vendor pemeriksaan usia, termasuk Didit.
  • Di California, jangan meminta pengguna untuk mengubah informasi usia mereka, dan jangan bagikan sinyal kepada pihak ketiga untuk tujuan yang tidak diwajibkan oleh undang-undang tersebut.[15]
  • Konsultasikan dengan penasihat hukum sebelum meminta sinyal untuk setiap pengguna: undang-undang California melarang permintaan yang tidak diwajibkan oleh undang-undang tersebut maupun hukum lain yang berlaku.[15]

Jadi pesan "visit the Play Store" diperuntukkan bagi VERIFICATION_REQUIRED, bukan untuk warga California yang rentang usianya Anda ragukan. Halaman regional Google mencantumkan California dan Brasil sebagai wajib mulai Januari 2027 dan Alabama sebagai "Details coming soon".[16] Kewajiban California dimuat dalam panduan Digital Age Assurance Act.

Setelah sinyal: mulai pemeriksaan Anda sendiri

Aplikasi Anda menentukan bahwa pemeriksaan diperlukan; permintaan tersebut memuat alur kerja dan ID pengguna Anda, bukan jawaban Google. Panggil Didit dari server Anda, karena kunci API tidak boleh sampai ke perangkat.

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"
  }'

Respons 201 memuat session_id, session_token, dan url.[25] Kirimkan hanya token tersebut ke aplikasi, lalu mulai 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()
    }
}

Hasil SDK ditujukan untuk antarmuka. Ambil keputusan dari webhook status.updated yang ditandatangani, atau baca GET /v3/session/{sessionId}/decision/ dari server Anda.[25][29] Pertahankan default yang aman saat pembatalan dan kegagalan.

Ketahui batasannya

Jika sinyal sudah cukup, lewati langkah ini. Pemeriksaan mandiri tidak selalu menang. Undang-undang Alabama dan Utah, dengan kewajiban mulai 2027, menggunakan kategori usia terendah untuk perlindungan yang mereka cakup, dan Brasil menggunakan alternatif yang lebih melindungi, sehingga di sana pemeriksaan hanya dapat memperketat.[22][23][24] Orang-orang yang dicakup oleh hukum Illinois, Texas, atau Colorado memerlukan langkah persetujuan biometrik sebelum selfie, yang dapat ditampilkan oleh SDK native 4.10.0 atau yang lebih baru.[28] Konfirmasikan dengan penasihat hukum mengenai aturan mana yang berlaku untuk aplikasi Anda.

Cara Didit membantu setelah sinyal

Didit Age Estimation memperkirakan usia dari swafoto, dengan liveness pada langkah yang sama, dan tidak mengungkap identitas orang tersebut. Alur kerja dapat mengirim rentang batas (borderline) yang Anda tetapkan ke pemeriksaan dokumen.[27] Biaya Age Estimation adalah $0.10 per panggilan; lihat harga.

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

Hasil estimasi usia di konsol Didit (data sampel): perkiraan dari swafoto di sebelah usia pada dokumen.

SDK native tersedia untuk Android, iOS, React Native, dan Flutter. Untuk Unity dan engine lainnya, rute yang terdokumentasi adalah integrasi WebView.[31] Platform di luar Google Play dibahas dalam Age verification API: apps, web and stores dan di halaman solusi verifikasi usia.

Didit menyediakan

  • Pemeriksaan usia yang dihosting dengan swafoto, liveness, dan langkah dokumen opsional
  • Opsi alur kerja ISO/IEC 27566-1 yang mengembalikan keputusan ya atau tidak mengenai usia dan tanpa data pribadi, dari usia minimum 13[27]
  • Jendela retensi, opsi data yang dikembalikan, dan panggilan penghapusan[30]

Tetap berada di pihak Anda

  • Panggilan Play Age Signals dan hasilnya
  • Hukum mana yang berlaku dan apakah pemeriksaan memang diperlukan
  • Pengaturan default yang sesuai usia dan keputusan akses akhir

Didit tidak memiliki konektor Play Age Signals: sinyal tetap berada di aplikasi Anda.

Lihat cabang cadangan (fallback) yang berjalan di aplikasi Anda

Bawa gerbang usia, pasar, dan stack Anda, atau bangun alur kerjanya sendiri.

Dapatkan demoMulai gratisBaca dokumentasi

Poin-poin penting

  • Gunakan 0.0.6: panggilan fitur opsional, permintaan akses, lalu checkAgeSignals hanya saat SHARED.
  • Lakukan pembatasan berdasarkan ageLower; ageUpper yang bernilai null menandakan rentang teratas, dan usia kustom dapat menurunkannya ke bawah 18.
  • Batas null, UNSPECIFIED, dan kesalahan berarti tidak ada sinyal, bukan dewasa.
  • Manifest 0.0.6 mendeklarasikan minSdk 24.
  • Simpan sinyal di aplikasi Anda dan mulai pemeriksaan mandiri tanpa sinyal tersebut.

Pertanyaan yang sering diajukan

Versi Play Age Signals API mana yang harus saya gunakan?

Gunakan 0.0.6. Ini adalah versi saat ini, tersedia secara global, dan Google menyatakan bahwa versi ini akan mengembalikan respons untuk semua pengguna paling lambat 11 Desember 2026; sementara itu, 0.0.4 terus mengembalikan respons di wilayah tertentu.[2]

Apakah saya perlu memanggil getApplicableAgeFeatures?

Tidak, Google menandainya sebagai opsional. Panggil fungsi ini jika layar Anda perlu disesuaikan untuk pengguna yang pembagian datanya bersifat wajib.[2]

Apa perbedaan antara NOT_SHARED dan VERIFICATION_REQUIRED?

NOT_SHARED berarti aplikasi Anda tidak menerima sinyal usia karena pengguna atau orang tua tidak setuju untuk membagikannya. VERIFICATION_REQUIRED berarti usia belum diverifikasi di wilayah tempat verifikasi dan pembagian bersifat wajib, dan Google meminta Anda untuk mengarahkan pengguna mengunjungi Play Store.[2]

Mengapa kedua batas bernilai null?

Referensi respons memberikan batas null saat statusnya adalah NOT_SHARED atau VERIFICATION_REQUIRED.[3] Perlakukan batas null sebagai ketiadaan sinyal, dan jangan pernah sebagai orang dewasa.

Mengapa ageUpper bernilai null untuk orang dewasa?

Karena rentang teratas bersifat terbuka: 18+ mengembalikan ageLower 18 dan ageUpper null.[3] Dengan usia kustom, rentang teratas dapat dimulai lebih rendah, jadi bandingkan ageLower dengan usia minimum Anda sendiri.

Dapatkah saya menetapkan rentang usia saya sendiri?

Ya, hingga tiga usia minimum pada halaman Age signals di Play Console, dengan selisih minimal dua tahun, dan dapat diubah setahun sekali. Usia minimum ini menggantikan rentang default.[3]

Bagaimana cara melakukan pengujian sebelum undang-undang berlaku?

Gunakan FakeAgeSignalsManager untuk mengembalikan status, rentang, atau kesalahan apa pun, termasuk MANDATORY_SHARING. Akun penguji lisensi memungkinkan build debug sideload memanggil API langsung.[6]

Apakah ini berfungsi di Trusted Web Activity atau WebView?

Tidak dari kode web. Ini adalah pustaka Android yang dipanggil dengan sebuah Activity, dan halaman Google yang kami baca tidak mendokumentasikan antarmuka web apa pun. Aplikasi wrapper akan membutuhkan kode native sendiri, dan ketentuan Google membatasi informasi hanya untuk aplikasi yang meminta.[2][5]

Apakah ada plugin Unity, Flutter, atau React Native?

Terdapat paket komunitas dan framework. Paket yang kami periksa pada 22 November 2026 mendeklarasikan 0.0.4, sehingga tidak memiliki getApplicableAgeFeatures. Staf Unity menyatakan pada Desember 2025 bahwa Unity tidak akan merilis plugin khusus.[17][18][19][20][21]

Dapatkah saya menyimpan hasilnya di server saya?

Halaman Google secara tegas menjelaskan penyimpanan installId di backend Anda untuk pemberitahuan pencabutan. Untuk selebihnya, simpan data seminimal mungkin sesuai kebutuhan kewajiban hukum Anda, di dalam sistem Anda sendiri, dan jangan pernah di analitik, periklanan, atau layanan pihak ketiga kecuali undang-undang secara ketat mewajibkannya.[9][13]

Sumber

  1. Gunakan Play Age Signals API (beta), Android Developers, diperbarui 19 November 2026.
  2. Minta sinyal usia, Android Developers, diperbarui 18 November 2026.
  3. Pahami respons sinyal usia, Android Developers, diperbarui 18 November 2026.
  4. Catatan rilis Play Age Signals, Android Developers, diperbarui 19 November 2026.
  5. Ringkasan dan ketentuan layanan Play Age Signals, Android Developers, diperbarui 18 November 2026.
  6. Uji integrasi Play Age Signals API (beta) Anda, Android Developers, diperbarui 19 November 2026.
  7. Referensi kode kesalahan Play Age Signals API, Android Developers, diperbarui 18 November 2026.
  8. Beri tahu Google Play tentang perubahan signifikan, Android Developers, diperbarui 4 September 2026.
  9. Tinjau persetujuan aplikasi yang dicabut, Android Developers, diperbarui 4 September 2026.
  10. Referensi AgeRangeSource, Android Developers, diperbarui 18 November 2026.
  11. com.google.android.play:age-signals, Google Maven; manifest pustaka dan kelas dari versi 0.0.3, 0.0.4, dan 0.0.6 dibaca pada 22 November 2026.
  12. Gunakan Play Age Signals API, versi 0.0.3, Android Developers, diperbarui 23 Oktober 2026.
  13. Kebijakan Age Signals API dan Data Pengguna, Bantuan Google Play Console.
  14. Tentang pembagian rentang usia di Google Play, Bantuan Google Play.
  15. AB 1856, Chapter 184, Statutes of 2026, California Legislative Information; mengubah Civil Code 1798.500 hingga 1798.504.
  16. Perlindungan terkait usia regional di Play, Android Developers, diperbarui 18 November 2026.
  17. Expo AgeRange, dokumentasi Expo; paket expo-age-range 58.0.3.
  18. age_range_signals, pub.dev, versi 0.10.1 per 6 Oktober 2026.
  19. react-native-play-age-range-declaration, GitHub, versi 3.0.5.
  20. unity-play-age-signals, GitHub, diperbarui 4 Agustus 2026.
  21. Play Age Signals API Support, Unity Discussions, tanggapan staf Unity dari Desember 2025.
  22. Code of Alabama 8-19K-9 (HB 161), Alabama Legislature.
  23. Utah Code 13-76-202, Utah Legislature; kewajiban pengembang mulai 6 Mei 2027.
  24. Decreto 12.880 tanggal 18 Maret 2026, art. 25, Planalto, Brasil.
  25. Create session, dokumentasi Didit.
  26. Android SDK, dokumentasi Didit.
  27. Ikhtisar Age Estimation, dokumentasi Didit.
  28. Persetujuan biometrik, dokumentasi Didit.
  29. Webhook, dokumentasi Didit.
  30. Retensi data, dokumentasi Didit.
  31. Ikhtisar Native SDK, dokumentasi Didit.
  32. Referensi FakeAgeSignalsManager, Android Developers, diperbarui 18 November 2026.

Terapkan ketiga panggilan tersebut, uji setiap baris tabel, dan simpan sinyal di tempat yang ditentukan oleh ketentuan Google: di dalam aplikasi Anda. Untuk cabang yang tidak dapat dijawab, tambahkan estimasi usia sebagai pemeriksaan Anda sendiri.

Tambahkan pemeriksaan untuk pengguna tanpa sinyal

Minta demo estimasi usia di aplikasi Anda, atau buat alur kerja dan mulai sesi hari ini.

Dapatkan demoMulai gratis

Infrastruktur untuk identitas dan fraud.

Satu API untuk KYC, KYB, Transaction Monitoring, dan Wallet Screening. Integrasi dalam 5 menit.

Minta AI untuk merangkum halaman ini