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.

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.
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
minSdkke 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.
- Februari 20260.0.3Satu panggilan,
userStatus, menambahkan DECLARED. - Juli 20260.0.4Dua panggilan, tier menggantikan
userStatus. - November 20260.0.6Global, menambahkan
getApplicableAgeFeatures. - 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
3checkAgeSignals
Baca batas, sumber, status perubahan.
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]
| Pengguna | Dialog | Status |
|---|---|---|
| Negara bagian AS tempat toko wajib memberikan usia terverifikasi (pengguna terverifikasi atau diawasi) | Tidak ada | SHARED |
| Sama, belum diverifikasi | Tidak ada di aplikasi Anda; Play menanganinya | VERIFICATION_REQUIRED |
| Di tempat lain, Tanya sebelum membagikan (default[14]) | Dialog dalam aplikasi milik Play | SHARED atau NOT_SHARED |
| Di tempat lain, Selalu bagikan | Tidak ada | SHARED |
| Di tempat lain, Jangan pernah bagikan | Tidak ada | NOT_SHARED |
| Di tempat lain, diawasi | Tidak ada; orang tua memutuskan di Family Link | SHARED 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.
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.
| Status | Sumber | Bawah / atas | Arti | Tindakan kode Anda |
|---|---|---|---|---|
| Eksepsi | tidak ada | tidak ada | Tidak ada respons[7] | Coba lagi jika dapat diulang, lalu anggap tidak ada sinyal |
NOT_SHARED | null | null / null | Pengguna atau orang tua tidak setuju untuk membagikan[2][3] | Gunakan default yang sesuai usia, jangan tampilkan dialog lagi |
VERIFICATION_REQUIRED | null | null / null | Belum diverifikasi, di wilayah tempat verifikasi dan pembagian bersifat wajib[2][3] | Arahkan ke Play Store, pertahankan default |
SHARED | TIER_A | 13 / 15 | Pengguna memberikan usia kepada Google, yang mungkin telah atau belum mengonfirmasinya[3] | Terapkan rentang tersebut |
SHARED | TIER_A | 18 / null | Sama, rentang dewasa[3] | Terapkan; tambahkan pemeriksaan hanya jika hukum atau risiko menuntut lebih |
SHARED | TIER_B | 13 / 15 | Usia dikelola oleh orang tua atau wali[3] | Terapkan rentang tersebut, baca status perubahannya |
SHARED | TIER_C | 18 / null | Dinilai melalui kartu kredit, email, selfie, kartu identitas pemerintah, atau ID pajak[3] | Terapkan rentang tersebut |
SHARED | TIER_D | 18 / null | Kartu identitas pemerintah ditambah selfie, atau identitas digital[3] | Terapkan rentang tersebut |
SHARED | apa pun | null / apa pun | Tidak ada dalam tabel respons Google | Perlakukan 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.
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 ditetapkan | Rentang yang dikembalikan | Rentang teratas |
|---|---|---|
| Tidak ada (default) | 0-12, 13-15, 16-17, 18+ | 18 / null |
| 15 | 0-14, 15+ | 15 / null |
| 13, 17 | 0-12, 13-16, 17+ | 17 / null |
| 11, 13, 15 | 0-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
significantChangeStatusbernilai 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
installIdberlaku 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)
}
| Kode | Konstanta | Coba lagi | Tindakan |
|---|---|---|---|
| -1, -6 | API_NOT_AVAILABLE, PLAY_STORE_VERSION_OUTDATED | Ya | Minta untuk memperbarui Play Store |
| -2 | PLAY_STORE_NOT_FOUND | Ya | Minta untuk menginstal atau mengaktifkan Play Store |
| -3 | NETWORK_ERROR | Ya | Minta untuk memeriksa koneksi |
| -4, -7 | PLAY_SERVICES_NOT_FOUND, PLAY_SERVICES_VERSION_OUTDATED | Ya | Minta untuk menginstal, mengaktifkan, atau memperbarui Play Services |
| -5 | CANNOT_BIND_TO_SERVICE | Ya | Backoff eksponensial, lalu perbarui Play Store |
| -8 | CLIENT_TRANSIENT_ERROR | Ya | Percobaan ulang terbatas, lalu coba lagi nanti |
| -9 | APP_NOT_OWNED | Tidak | Tidak diinstal oleh Google Play: sideload atau toko lain |
| -10 | SDK_VERSION_OUTDATED | Tidak | Rilis pustaka yang lebih baru |
| -11 | DEVICE_NOT_SUPPORTED | Tidak | Jenis perangkat tidak dilayani; baru di 0.0.6[4] |
| -100 | INTERNAL_ERROR | Tidak | Teks 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 Anda | Di 0.0.6 | Dari |
|---|---|---|
Hanya checkAgeSignals | requestAgeSignalsAccess terlebih dahulu[4] | 0.0.3 |
userStatus() | Dihapus: ageRangeSource() dan significantChangeStatus()[4] | 0.0.3 |
VERIFIED | TIER_C atau TIER_D (penafsiran kami) | 0.0.3 |
DECLARED | TIER_A, atau TIER_B jika dikelola oleh orang tua (penafsiran kami) | 0.0.3 |
SUPERVISED | TIER_B (penafsiran kami) | 0.0.3 |
SUPERVISED_APPROVAL_PENDING, SUPERVISED_APPROVAL_DENIED | TIER_B dengan PENDING atau DECLINED (penafsiran kami) | 0.0.3 |
UNKNOWN, null | Status akses: VERIFICATION_REQUIRED atau NOT_SHARED (penafsiran kami) | 0.0.3 |
mostRecentApprovalDate() | significantChangeApprovalDate()[4] | 0.0.3 |
| Dua panggilan, tier | Tidak berubah; tambahkan getApplicableAgeFeatures jika berguna[4] | 0.0.4 |
| Penanganan kesalahan | Tambahkan DEVICE_NOT_SUPPORTED[4] | Keduanya |
minSdk 23 | Pustaka 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 (
setNextRequestAgeSignalsAccessExceptiondansetNextApplicableAgeFeaturesExceptionmenggagalkan 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.
| Stack | Paket yang diperiksa | Pustaka | Ketahui sebelum Anda merilis |
|---|---|---|---|
| Expo | expo-age-range 58.0.3 | 0.0.4 | Pada web dan pada iOS sebelum 26, ini mengembalikan lowerBound: 18, seperti orang dewasa[17] |
| React Native | react-native-play-age-range-declaration 3.0.5 | 0.0.4 | Juga membungkus toko lain dan Apple[19] |
| Flutter | age_range_signals 0.10.1 | 0.0.4 | Alur dua panggilan, dukungan penguji lisensi[18] |
| Unity | unity-play-age-signals | 0.0.4 | GPL-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
installIddari 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.

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.
Poin-poin penting
- Gunakan 0.0.6: panggilan fitur opsional, permintaan akses, lalu
checkAgeSignalshanya saatSHARED. - Lakukan pembatasan berdasarkan
ageLower;ageUpperyang 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
- Gunakan Play Age Signals API (beta), Android Developers, diperbarui 19 November 2026.
- Minta sinyal usia, Android Developers, diperbarui 18 November 2026.
- Pahami respons sinyal usia, Android Developers, diperbarui 18 November 2026.
- Catatan rilis Play Age Signals, Android Developers, diperbarui 19 November 2026.
- Ringkasan dan ketentuan layanan Play Age Signals, Android Developers, diperbarui 18 November 2026.
- Uji integrasi Play Age Signals API (beta) Anda, Android Developers, diperbarui 19 November 2026.
- Referensi kode kesalahan Play Age Signals API, Android Developers, diperbarui 18 November 2026.
- Beri tahu Google Play tentang perubahan signifikan, Android Developers, diperbarui 4 September 2026.
- Tinjau persetujuan aplikasi yang dicabut, Android Developers, diperbarui 4 September 2026.
- Referensi AgeRangeSource, Android Developers, diperbarui 18 November 2026.
- 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.
- Gunakan Play Age Signals API, versi 0.0.3, Android Developers, diperbarui 23 Oktober 2026.
- Kebijakan Age Signals API dan Data Pengguna, Bantuan Google Play Console.
- Tentang pembagian rentang usia di Google Play, Bantuan Google Play.
- AB 1856, Chapter 184, Statutes of 2026, California Legislative Information; mengubah Civil Code 1798.500 hingga 1798.504.
- Perlindungan terkait usia regional di Play, Android Developers, diperbarui 18 November 2026.
- Expo AgeRange, dokumentasi Expo; paket expo-age-range 58.0.3.
- age_range_signals, pub.dev, versi 0.10.1 per 6 Oktober 2026.
- react-native-play-age-range-declaration, GitHub, versi 3.0.5.
- unity-play-age-signals, GitHub, diperbarui 4 Agustus 2026.
- Play Age Signals API Support, Unity Discussions, tanggapan staf Unity dari Desember 2025.
- Code of Alabama 8-19K-9 (HB 161), Alabama Legislature.
- Utah Code 13-76-202, Utah Legislature; kewajiban pengembang mulai 6 Mei 2027.
- Decreto 12.880 tanggal 18 Maret 2026, art. 25, Planalto, Brasil.
- Create session, dokumentasi Didit.
- Android SDK, dokumentasi Didit.
- Ikhtisar Age Estimation, dokumentasi Didit.
- Persetujuan biometrik, dokumentasi Didit.
- Webhook, dokumentasi Didit.
- Retensi data, dokumentasi Didit.
- Ikhtisar Native SDK, dokumentasi Didit.
- 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.
Artikel terkait
- Google Play Age Signals API: apa yang berubah pada Januari 2027
- Age assurance for apps: games, social, dating, AI and more
- Age verification API: which one works on apps, web and stores
- Brazil's ECA Digital and Google Play: age signals in your app
- California age verification law 2027: the four rules for apps
- App Store Accountability Acts: Texas, Utah, Louisiana, Alabama