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 VERIFIED, DECLARED, SUPERVISED, 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.
          }
        });

(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+.

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. Rentang usia yang ditampilkan akan menggantikan respons API default. 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 default 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 di Brasil

Di Brasil, userStatus hanya dapat berupa DECLARED, UNKNOWN, atau null.

Untuk pengguna yang menyatakan usianya dan membagikannya ke aplikasi, Anda akan menerima hal berikut:

• userStatus akan menjadi AgeSignalsVerificationStatus.DECLARED.
• ageLower akan berupa angka (misalnya, 13).
• ageUpper akan berupa angka atau null (misalnya, 15).
• Kolom respons lainnya adalah null.

Untuk pengguna yang usianya tidak diketahui, Anda akan menerima hal berikut:

• userStatus akan menjadi AgeSignalsVerificationStatus.UNKNOWN.
• Kolom respons lainnya adalah null.

Untuk pengguna yang usianya tidak dibagikan ke aplikasi, Anda akan menerima hal berikut:

• userStatus akan menjadi null.
• Kolom respons lainnya adalah null.

Status pengguna dapat berubah menjadi DECLARED setelah usia pengguna tersedia untuk dibagikan.

Contoh respons untuk pengguna di negara bagian AS

Di negara bagian AS yang berlaku, userStatus dapat berupa VERIFIED, SUPERVISED, SUPERVISED_APPROVAL_PENDING, SUPERVISED_APPROVAL_DENIED, UNKNOWN, atau null.

Untuk pengguna terverifikasi, Anda akan menerima hal berikut:

• userStatus akan menjadi AgeSignalsVerificationStatus.VERIFIED.
• ageLower akan berupa angka (misalnya, 18).
• ageUpper akan berupa angka atau null (misalnya, null).
• Kolom respons lainnya adalah null.

Untuk pengguna yang diawasi, Anda akan menerima hal berikut:

• userStatus akan menjadi AgeSignalsVerificationStatus.SUPERVISED.
• ageLower akan berupa angka (misalnya, 13).
• ageUpper akan berupa angka atau null (misalnya, 15).
• mostRecentApprovalDate akan menjadi objek tanggal Java (misalnya, 2026-01-01) atau null (jika tidak ada perubahan signifikan yang disetujui).
• installID akan berupa 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 atau null (misalnya, 15).
• mostRecentApprovalDate akan menjadi objek tanggal Java (misalnya, 2026-01-01) atau null (jika tidak ada perubahan signifikan yang disetujui).
• installID akan berupa 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.