Play Age Signals API'yi (beta) kullanma

Play Age Signals API'yi (beta) kullanarak hizmet şartlarını kabul etmiş ve tüm Google Play geliştirici politikalarına uymayı kabul etmiş olursunuz. Kullanıcının durumunu ve yaş aralığını istemek için çalışma zamanında uygulamanızdan API'yi çağırırsınız. Play Age Signals API yalnızca Play'in yaş kategorisi verileri sağlamasının yasal olarak zorunlu olduğu bölgelerdeki kullanıcıların verilerini döndürür.

Play, geçerli yargı alanı ve bölgeler tarafından tanımlanan yaş aralıklarına göre bir yaş aralığı döndürür. API'nin geçerli yargı alanlarında ve bölgelerde döndürdüğü varsayılan yaşlar 0-12, 13-15, 16-17 ve 18+'dır ancak bunlar bölgesel şartlara göre değişebilir.

Play Age Signals API'yi uygulamanıza entegre etme

Play Age Signals API'yi uygulamanıza entegre etmek için uygulamanızın build.gradle dosyasına aşağıdaki bağımlılığı ekleyin:

implementation 'com.google.android.play:age-signals:0.0.1-beta01'

Yaş sinyalleri isteyin

Aşağıda, yaş sinyalleri isteğinde bulunma örneği verilmiştir:

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

Yaş sinyalleri, Google Play tarafından cihazda her kullanıcı için saklanır. Denetimli Google Hesabı olan bir kullanıcı yeni bir yaş aralığına girdiğinde Google Play, kullanıcının doğum gününden sonraki 2-8 hafta içinde kullanıcının önbelleğe alınmış yaş sinyallerini otomatik olarak günceller.

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

API'nin geçerli yargı alanlarında ve bölgelerde döndürdüğü varsayılan yaş aralıkları 0-12, 13-15, 16-17 ve 18 yaş üstüdür. Bu aralıklar, gelecekte yerel şartlara göre değişebilir.

Alternatif olarak, yaş aralıklarını uygulamanızın minimum yaşlarına göre özelleştirmek için Google Play Console'daki Yaş sinyalleri sayfasında uygulamanızın minimum yaşlarını belirtebilirsiniz. Age Signals API, özelleştirilmiş yaş aralıklarını döndürür. Örneğin, 9, 15 ve 17 yaşlarını minimum yaş olarak belirtirseniz 14 yaşındaki bir kullanıcı 10-15 yaş aralığına girer. Minimum yaşlar arasında en az 2 yıl fark olmalı ve bu yaşlar yılda bir kez değiştirilebilir.

Age Signals API tarafından döndürülen 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. Uygulamanın minimum yaşları sekmesinde, uygulamanız için en fazla üç minimum yaş girin.
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.

API hata kodlarını işleme

Uygulamanız Play Age Signals API (beta) 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.