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.

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 bisa diubah sekali setahun.
3. 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.

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 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 akan berupa null.

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

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

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

• userStatus akan berupa null.
• Kolom respons lainnya akan berupa 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 yang 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 akan berupa 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 berupa 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 tertunda, Anda akan menerima hal berikut:

• userStatus akan menjadi AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING.
• ageLower akan berupa angka (misalnya, 13).
• ageUpper akan berupa angka atau null (misalnya, 15).
• mostRecentApprovalDate akan berupa 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 Google Play Store yang sudah tidak berlaku.

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.