Pada 17 Maret 2026, Play Age Signals API mulai menampilkan sinyal usia untuk pengguna di Brasil untuk persyaratan berdasarkan Digital ECA. API ini telah mulai menampilkan sinyal usia untuk pengguna yang memenuhi syarat di Texas yang membuat akunnya setelah 28 Mei 2026 sebagai bagian dari upaya kepatuhan kami terhadap SB2420 Texas. Info terbaru akan diberikan sebelum rancangan undang-undang verifikasi usia diberlakukan di negara bagian AS lainnya.

Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Memahami respons sinyal usia

Dokumen ini menjelaskan respons sinyal usia yang ditampilkan oleh Play Age Signals API.

(Opsional) Menerima rentang usia kustom

Rentang usia default yang ditampilkan API adalah 0-12, 13-15, 16-17, dan 18+.

Atau, untuk menyesuaikan rentang usia default sesuai usia minimum aplikasi Anda, Anda dapat memberikan usia minimum ini untuk aplikasi Anda di halaman Sinyal usia di Konsol Google Play.

Buka halaman Sinyal usia di Konsol Play.
Di tab Rentang usia kustom, masukkan hingga tiga usia minimum untuk aplikasi Anda. Usia minimum harus memiliki selisih setidaknya 2 tahun dan bisa diubah sekali setahun.
Klik Simpan.

Rentang usia yang ditampilkan akan mengganti respons API default. Contoh:

Jika Anda menetapkan satu usia minimum (15) di Konsol Google Play:
- Pengguna berusia 0 hingga 14 tahun akan menampilkan ageLower = 0 dan ageUpper = 14.
- Pengguna berusia 15 tahun ke atas akan menampilkan ageLower = 15.
Jika Anda menetapkan dua usia minimum (13 dan 17):
- Pengguna berusia 0 hingga 12 tahun akan menampilkan ageLower = 0 dan ageUpper = 12.
- Pengguna berusia 13 hingga 16 tahun akan menampilkan ageLower = 13 dan ageUpper = 16.
- Pengguna berusia 17 tahun ke atas akan menampilkan ageLower = 17.
Jika Anda menetapkan tiga usia minimum (11, 13, dan 15):
- Pengguna berusia 0 hingga 10 tahun akan menampilkan ageLower = 0 dan ageUpper = 10.
- Pengguna berusia 11 atau 12 tahun akan menampilkan ageLower = 11 dan ageUpper = 12.
- Pengguna berusia 13 atau 14 tahun akan menampilkan ageLower = 13 dan ageUpper = 14.
- Pengguna berusia 15 tahun ke atas akan menampilkan ageLower = 15.

Kolom respons sinyal usia

Respons Play Age Signals API (beta) mencakup kolom dan nilai berikut. Anda bertanggung jawab untuk memberikan pengalaman yang sesuai usia menggunakan sinyal ini.

Kolom respons	Jenis	Nilai	Deskripsi
ageRangeSource	Enum	TIER_A TIER_B TIER_C TIER_D null	TIER_A: Pengguna telah menyatakan usianya sendiri. TIER_B: Usia pengguna dikelola oleh orang tua atau wali. TIER_C: Usia pengguna dinilai menggunakan kartu kredit, alamat email, penilaian foto selfie, Tanda Pengenal yang dikeluarkan Pemerintah, atau Nomor Pokok Wajib Pajak. TIER_D: Usia pengguna diperiksa menggunakan kombinasi Tanda Pengenal yang dikeluarkan Pemerintah dan penilaian foto selfie, atau Tanda Pengenal Digital. null: Ditampilkan saat ageSignalsStatus adalah NOT_SHARED atau VERIFICATION_REQUIRED.
ageLower	Bilangan Bulat	0 hingga 18 null	Batas bawah inklusif rentang usia pengguna. Gabungkan dengan ageUpper untuk menentukan rentang. Menampilkan null jika ageSignalsStatus adalah NOT_SHARED atau VERIFICATION_REQUIRED.
ageUpper	Bilangan Bulat	2 hingga 18 null	Batas atas inklusif rentang usia pengguna. Menampilkan null untuk rentang tertinggi (misalnya, 18+) atau jika ageSignalsStatus adalah NOT_SHARED atau VERIFICATION_REQUIRED.
significantChangeStatus	Enum	DISETUJUI TERTUNDA DITOLAK null	Kolom ini hanya menampilkan nilai non-null di wilayah hukum tempat perubahan signifikan berlaku. DISETUJUI: Perubahan signifikan terbaru (dan semua perubahan sebelumnya) telah disetujui. TERTUNDA: Orang tua belum menyetujui satu atau beberapa perubahan signifikan yang tertunda. DITOLAK: Orang tua menolak menyetujui satu atau beberapa perubahan signifikan. null: Ditampilkan untuk: Semua akun yang tidak diawasi Akun yang diawasi yang belum memiliki perubahan signifikan yang tercatat.
significantChangeApprovalDate	Tanggal	DateStamp null	Tanggal mulai berlaku perubahan signifikan yang paling baru disetujui. Semua perubahan dengan tanggal efektif sebelum tanggal ini juga disetujui. Menampilkan null jika tidak ada perubahan. Gabungkan dengan `significantChangeStatus` untuk mendapatkan status persetujuan untuk perubahan signifikan ini
installId	String	Alfanumerik null	ID yang ditetapkan ke penginstalan pengguna yang diawasi oleh Google Play, yang digunakan untuk memberi tahu Anda tentang persetujuan aplikasi yang dicabut. Tinjau dokumentasi untuk persetujuan aplikasi yang dicabut.

Contoh 1

Untuk pengguna yang memverifikasi usianya menggunakan Tanda Pengenal Digital dan membagikannya ke aplikasi, Anda akan menerima hal berikut:

ageRangeSource adalah AgeRangeSource.TIER_D.
ageLower adalah angka (misalnya, 18).
ageUpper adalah null.
Kolom respons lainnya adalah null.

Contoh 2

Untuk pengguna dewasa yang menyatakan usianya (dinyatakan sendiri) dan membagikannya ke aplikasi, Anda akan menerima hal berikut:

ageRangeSource adalah AgeRangeSource.TIER_A.
ageLower adalah angka (misalnya, 18).
ageUpper adalah null.
Kolom respons lainnya adalah null.

Contoh 3

Untuk pengguna anak-anak yang diawasi yang usianya dikelola oleh wali yang telah membagikannya ke aplikasi, Anda akan menerima hal berikut:

ageRangeSource adalah AgeRangeSource.TIER_B.
ageLower adalah angka (misalnya, 13).
ageUpper adalah angka (misalnya, 15).
Kolom respons lainnya adalah null.

Contoh 4

Untuk pengguna yang tidak menyetujui (atau orang tuanya tidak menyetujui) pembagian usia, Anda akan menerima hal berikut:

ageRangeSource adalah null.
ageLower adalah null.
ageUpper adalah null.
Kolom respons lainnya adalah null.

Contoh 5

Untuk pengguna dewasa dengan usia yang dinilai dan diverifikasi menggunakan metode estimasi usia (seperti penilaian foto selfie, kartu kredit, atau Nomor Pokok Wajib Pajak) yang membagikannya ke aplikasi, Anda akan menerima hal berikut:

ageRangeSource adalah AgeRangeSource.TIER_C.
ageLower adalah angka (misalnya, 18).
ageUpper adalah null.
Kolom respons lainnya adalah null.

Contoh 6

Untuk pengguna anak-anak yang diawasi yang usianya dikelola oleh wali, dengan perubahan signifikan yang disetujui dan pelacakan penginstalan aktif, Anda akan menerima hal berikut:

ageRangeSource adalah AgeRangeSource.TIER_B.
ageLower adalah angka (misalnya, 13).
ageUpper adalah angka (misalnya, 15).
significantChangeStatus adalah SignificantChangeStatus.APPROVED.
significantChangeApprovalDate adalah Tanggal (misalnya, "2026-01-15").
installId adalah ID string (misalnya, "abc123xyz789").