Play Age Signals API'yi (beta) kullanma

// 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.
          }
        });

(İsteğe bağlı) Özel yaş aralıkları alın

API'nin geçerli yargı alanları ve bölgelerde döndürdüğü varsayılan yaş aralıkları 0-12, 13-15, 16-17 ve 18+ şeklindedir.

Alternatif olarak, varsayılan yaş aralıklarını uygulamanızın minimum yaşlarına göre özelleştirmek için Google Play Console'daki Age Signals sayfasında uygulamanızın minimum yaşlarını belirtebilirsiniz. Döndürülen yaş aralıkları, varsayılan API yanıtını geçersiz kılar. Örneğin, minimum yaşları 9, 15 ve 17 olarak girerseniz 14 yaşındaki bir kullanıcı 10-15 yaş grubuna dahil edilir.

Age Signals API tarafından döndürülen varsayılan yaş aralıklarını özelleştirmek için uygulamanızın minimum yaşlarını belirtebilirsiniz:

1. Play Console'da Yaş sinyalleri sayfasına gidin.
2. Özel yaş aralıkları sekmesinde uygulamanız için en fazla üç minimum yaş girin. Minimum yaşlar arasında en az 2 yıl fark olmalıdır ve bu ayar yılda yalnızca bir kez değiştirilebilir.
3. Kaydet'i tıklayın.

Yaş sinyalleri yanıtları

Play Age Signals API (Beta) yanıtı aşağıdaki alanları ve değerleri içerir. Değerler değişebilir. En son değerleri istiyorsanız uygulamanız açıldığında bir API yanıtı isteyin. Bu sinyalleri kullanarak yaşa uygun deneyimler sunmak sizin sorumluluğunuzdadır.

Brezilya'daki kullanıcılar için örnek yanıtlar

Brezilya'da userStatus yalnızca DECLARED, UNKNOWN veya null olabilir.

Yaşını beyan eden ve uygulamalarla paylaşan bir kullanıcı için aşağıdakileri alırsınız:

• userStatus, AgeSignalsVerificationStatus.DECLARED olurdu.
• ageLower bir sayı olmalıdır (örneğin, 13).
• ageUpper, bir sayı veya null (örneğin, 15) olmalıdır.
• Diğer yanıt alanları null olur.

Yaşı bilinmeyen bir kullanıcı için aşağıdakileri alırsınız:

• userStatus, AgeSignalsVerificationStatus.UNKNOWN olurdu.
• Diğer yanıt alanları null olur.

Yaşı uygulamalarla paylaşılmayan bir kullanıcı için aşağıdakileri alırsınız:

• userStatus, null olurdu.
• Diğer yanıt alanları null olur.

Kullanıcının yaşı paylaşılabilir olduğunda kullanıcı durumu DECLARED olarak değişebilir.

ABD eyaletlerindeki kullanıcılar için örnek yanıtlar

ABD'deki geçerli eyaletlerde userStatus, VERIFIED, SUPERVISED, SUPERVISED_APPROVAL_PENDING, SUPERVISED_APPROVAL_DENIED, UNKNOWN veya null olabilir.

Doğrulanmış bir kullanıcı için aşağıdakileri alırsınız:

• userStatus, AgeSignalsVerificationStatus.VERIFIED olurdu.
• ageLower bir sayı (örneğin, 18) olur.
• ageUpper, bir sayı veya null (örneğin, null) olmalıdır.
• Diğer yanıt alanları null olur.

Gözetimli kullanıcılar için aşağıdakileri alırsınız:

• userStatus, AgeSignalsVerificationStatus.SUPERVISED olurdu.
• ageLower bir sayı olmalıdır (örneğin, 13).
• ageUpper, bir sayı veya null (örneğin, 15) olmalıdır.
• mostRecentApprovalDate, bir Java tarih nesnesi (örneğin, 2026-01-01) veya null (önemli bir değişiklik onaylanmamışsa) olur.
• installID, Play tarafından oluşturulan alfanümerik bir kimlik olur (ör. 550e8400-e29b-41d4-a716-446655441111).

Onay bekleyen önemli bir değişiklik olan gözetimli kullanıcı için aşağıdakileri alırsınız:

• userStatus, AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING olur.
• ageLower bir sayı olmalıdır (örneğin, 13).
• ageUpper, bir sayı veya null (örneğin, 15) olmalıdır.
• mostRecentApprovalDate, bir Java tarih nesnesi (örneğin, 2026-01-01) veya null (önemli bir değişiklik onaylanmamışsa) olur.
• installID, Play tarafından oluşturulan alfanümerik bir kimlik olur (ör. 550e8400-e29b-41d4-a716-446655441111).

API hata kodlarını işleme

Uygulamanız Play Age Signals API isteğinde bulunur ve çağrı başarısız olursa uygulamanız bir hata kodu alır. Bu hatalar, Play Store uygulamasının güncel olmaması gibi çeşitli nedenlerden kaynaklanabilir.

Yeniden deneme stratejisi

Kullanıcının oturumda olduğu durumlarda, hatanın kullanıcı deneyimini mümkün olduğunca az etkilemesi için çıkış koşulu olarak maksimum deneme sayısına sahip bir yeniden deneme stratejisi uygulamanızı öneririz.