Menggunakan Play Age Signals API (beta)

// Create an instance of a manager
val ageSignalsManager =
    AgeSignalsManagerFactory.create(ApplicationProvider.getApplicationContext())

// Request an age signals check
ageSignalsManager
    .checkAgeSignals(AgeSignalsRequest.builder().build())
    .addOnSuccessListener { ageSignalsResult ->
        // Store the install ID for later...
        val installId = ageSignalsResult.installId()

        if (ageSignalsResult.userStatus() == AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_DENIED) {
          // Disallow access...
        } else {
           // Do something else if the user is SUPERVISED, VERIFIED, etc.
        }
    }

// Create an instance of a manager
AgeSignalsManager ageSignalsManager =
    AgeSignalsManagerFactory.create(ApplicationProvider.getApplicationContext());

// Request an age signals check
ageSignalsManager
    .checkAgeSignals(AgeSignalsRequest.builder().build())
    .addOnSuccessListener(
        ageSignalsResult -> {
          // Store the install ID for later...
          String installId = ageSignalsResult.installId();

          if (ageSignalsResult
              .userStatus()
              .equals(AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_DENIED)) {
            // Disallow access ...
          } else {
            // Do something else if the user is SUPERVISED, VERIFIED, etc.
          }
        });

Sinyal usia disimpan oleh Google Play di perangkat untuk setiap pengguna. Saat pengguna dengan Akun Google yang diawasi memasuki rentang usia baru, Google Play akan otomatis memperbarui sinyal usia yang di-cache untuk pengguna tersebut dalam waktu 2 hingga 8 minggu setelah ulang tahun pengguna.

(Opsional) Menerima rentang usia kustom

Rentang usia default yang ditampilkan API di wilayah hukum dan wilayah yang berlaku adalah 0—12, 13—15, 16—17, dan 18+. Rentang usia ini dapat berubah di masa mendatang berdasarkan persyaratan lokal.

Atau, untuk menyesuaikan rentang usia sesuai usia minimum aplikasi Anda, Anda dapat memberikan usia minimum ini untuk aplikasi Anda di halaman Sinyal usia di Konsol Google Play. Age Signals API menampilkan rentang usia yang disesuaikan. Misalnya, jika Anda memberikan usia minimum 9, 15, dan 17, pengguna berusia 14 tahun akan termasuk dalam rentang usia 10—15 tahun.

Untuk menyesuaikan rentang usia yang ditampilkan oleh Age Signals API, Anda dapat memberikan usia minimum untuk aplikasi Anda:

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

Respons sinyal usia

Respons Play Age Signals API (beta) mencakup kolom dan nilai berikut. Nilai dapat berubah sewaktu-waktu. Jika Anda menginginkan nilai terbaru, minta respons API saat aplikasi Anda dibuka. Anda bertanggung jawab untuk memberikan pengalaman yang sesuai dengan usia menggunakan sinyal ini.

Contoh respons

Untuk pengguna terverifikasi, Anda akan menerima hal berikut:

• userStatus akan menjadi AgeSignalsVerificationStatus.VERIFIED.
• Kolom respons lainnya akan kosong.

Untuk pengguna yang diawasi, Anda akan menerima hal berikut:

• userStatus akan menjadi AgeSignalsVerificationStatus.SUPERVISED.
• ageLower akan berupa angka (misalnya, 13).
• ageUpper akan berupa angka (misalnya, 15).
• mostRecentApprovalDate akan menjadi objek tanggal Java (misalnya, 2026-01-01) atau kosong (jika tidak ada perubahan signifikan yang disetujui).
• installID akan menjadi ID alfanumerik yang dibuat Play (misalnya, 550e8400-e29b-41d4-a716-446655441111).

Untuk pengguna yang diawasi dengan persetujuan perubahan signifikan yang tertunda, Anda akan menerima pesan berikut:

• userStatus akan menjadi AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING.
• ageLower akan berupa angka (misalnya, 13).
• ageUpper akan berupa angka (misalnya, 15).
• mostRecentApprovalDate akan menjadi objek tanggal Java (mis. 2026-01-01) atau kosong (jika tidak ada perubahan signifikan yang disetujui).
• installID akan menjadi ID alfanumerik yang dibuat Play (misalnya, 550e8400-e29b-41d4-a716-446655441111).

Menangani kode error API

Jika aplikasi Anda membuat permintaan Play Age Signals API dan panggilan gagal, aplikasi Anda akan menerima kode error. Error ini dapat terjadi karena berbagai alasan, seperti aplikasi Play Store yang sudah tidak update.

Strategi percobaan ulang

Dalam situasi ketika pengguna sedang berada dalam sesi, sebaiknya implementasikan strategi percobaan ulang dengan jumlah maksimum upaya sebagai kondisi keluar sehingga error tersebut tidak akan mengganggu pengalaman pengguna.