Sử dụng Play Age Signals API (beta)

Bằng việc sử dụng API Tín hiệu về độ tuổi của Play (bản thử nghiệm), bạn đồng ý với điều khoản dịch vụ và đồng ý tuân thủ tất cả chính sách dành cho nhà phát triển của Google Play. Để yêu cầu trạng thái và độ tuổi của người dùng, bạn gọi API từ ứng dụng của mình trong thời gian chạy. Play Age Signals API chỉ trả về dữ liệu cho người dùng ở những khu vực mà Play bắt buộc phải cung cấp dữ liệu danh mục độ tuổi theo luật.

Play trả về một độ tuổi dựa trên các nhóm tuổi do khu vực tài phán và khu vực hiện hành xác định. Độ tuổi mặc định mà API trả về ở các khu vực tài phán và khu vực áp dụng là 0-12, 13-15, 16-17 và 18+, nhưng những độ tuổi này có thể thay đổi dựa trên các yêu cầu theo khu vực.

Tích hợp Play Age Signals API vào ứng dụng

Để tích hợp Play Age Signals API vào ứng dụng, hãy thêm phần phụ thuộc sau vào tệp build.gradle của ứng dụng:

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

Yêu cầu tín hiệu về độ tuổi

Sau đây là ví dụ về cách đưa ra yêu cầu về tín hiệu độ tuổi:

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

Google Play lưu trữ tín hiệu về độ tuổi trên thiết bị cho từng người dùng. Khi người dùng có Tài khoản Google được giám sát chuyển sang một độ tuổi mới, Google Play sẽ tự động cập nhật các tín hiệu độ tuổi được lưu vào bộ nhớ đệm cho người dùng đó trong vòng từ 2 đến 8 tuần kể từ ngày sinh nhật của người dùng.

(Không bắt buộc) Nhận độ tuổi tuỳ chỉnh

Các độ tuổi mặc định mà API trả về ở những khu vực tài phán và khu vực áp dụng là 0-12, 13-15, 16-17 và 18+. Các độ tuổi này có thể thay đổi trong tương lai dựa trên các yêu cầu của địa phương.

Ngoài ra, để tuỳ chỉnh các độ tuổi theo độ tuổi tối thiểu của ứng dụng, bạn có thể cung cấp các độ tuổi tối thiểu này cho ứng dụng của mình trên trang Age signals (Tín hiệu về độ tuổi) trong Google Play Console. Age Signals API trả về các độ tuổi tuỳ chỉnh. Ví dụ: nếu bạn cung cấp độ tuổi tối thiểu là 9, 15 và 17, thì người dùng 14 tuổi sẽ nằm trong độ tuổi từ 10 đến 15. Các độ tuổi tối thiểu phải cách nhau ít nhất 2 năm và bạn có thể thay đổi độ tuổi tối thiểu mỗi năm một lần.

Để tuỳ chỉnh các độ tuổi mà Age Signals API trả về, bạn có thể cung cấp độ tuổi tối thiểu cho ứng dụng của mình:

1. Chuyển đến trang Tín hiệu về độ tuổi trong Play Console.
2. Trên thẻ Độ tuổi tối thiểu của ứng dụng, hãy nhập tối đa 3 độ tuổi tối thiểu cho ứng dụng của bạn.
3. Nhấp vào Lưu.

Câu trả lời dựa trên dấu hiệu về độ tuổi

Phản hồi của API Tín hiệu về độ tuổi của Play (bản thử nghiệm) bao gồm các trường và giá trị sau. Các giá trị này có thể thay đổi. Nếu bạn muốn có các giá trị gần đây nhất, hãy yêu cầu phản hồi API khi ứng dụng của bạn mở. Bạn có trách nhiệm cung cấp trải nghiệm phù hợp với lứa tuổi bằng cách sử dụng những tín hiệu này.

Xử lý mã lỗi API

Nếu ứng dụng của bạn đưa ra yêu cầu API Tính hiệu về độ tuổi của Play (beta) và lệnh gọi không thành công, thì ứng dụng sẽ nhận được một mã lỗi. Những lỗi này có thể xảy ra vì nhiều lý do, chẳng hạn như ứng dụng Cửa hàng Play đã lỗi thời.

Chiến lược thử lại

Trong trường hợp người dùng đang hoạt động, bạn nên triển khai một chiến lược thử lại với điều kiện thoát là số lần thử tối đa để hạn chế tối đa việc lỗi làm gián đoạn trải nghiệm người dùng.