Sử dụng 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.
          }
        });

(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à từ 18 trở lên.

Ngoài ra, để tuỳ chỉnh các độ tuổi mặc định theo độ tuổi tối thiểu để dùng ứng dụng của bạn, 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 Dấu hiệu về độ tuổi trong Google Play Console. Các độ tuổi được trả về sẽ ghi đè phản hồi mặc định của API. Ví dụ: nếu bạn cung cấp độ tuổi tối thiểu là 9, 15 và 17, thì một người dùng 14 tuổi sẽ thuộc độ tuổi từ 10 đến 15.

Để tuỳ chỉnh các độ tuổi mặc định 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 Dấu hiệu về độ tuổi trong Play Console.
2. Trên thẻ Độ tuổi tuỳ chỉnh, hãy nhập tối đa 3 độ tuổi tối thiểu cho ứng dụng của bạn. 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 thông tin này mỗi năm một lần.
3. Nhấp vào Lưu.

Phản hồi về dấu hiệu độ tuổi

Phản hồi của Play Age Signals API (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 chịu 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.

Ví dụ về các phản hồi dành cho người dùng ở Brazil

Ở Brazil, userStatus chỉ có thể là DECLARED và UNKNOWN.

Đối với người dùng đã khai báo độ tuổi, bạn sẽ nhận được những thông tin sau:

• userStatus sẽ là AgeSignalsVerificationStatus.DECLARED.
• ageLower sẽ là một số (ví dụ: 13).
• ageUpper sẽ là một số hoặc null (ví dụ: 15).
• Các trường phản hồi khác sẽ là null.

Đối với người dùng có độ tuổi không xác định, bạn sẽ nhận được thông tin sau:

• userStatus sẽ là AgeSignalsVerificationStatus.UNKNOWN.
• Các trường phản hồi khác sẽ là null.

Trạng thái người dùng có thể thay đổi từ UNKNOWN thành DECLARED sau khi có thông tin về độ tuổi của người dùng để chia sẻ.

Ví dụ về câu trả lời cho người dùng ở các tiểu bang tại Hoa Kỳ

Ở các tiểu bang áp dụng tại Hoa Kỳ, userStatus có thể là VERIFIED, SUPERVISED, SUPERVISED_APPROVAL_PENDING, SUPERVISED_APPROVAL_DENIED, UNKNOWN hoặc null.

Đối với người dùng đã xác minh, bạn sẽ nhận được những thông tin sau:

• userStatus sẽ là AgeSignalsVerificationStatus.VERIFIED.
• ageLower sẽ là một số (ví dụ: 18).
• ageUpper sẽ là một số hoặc null (ví dụ: null).
• Các trường phản hồi khác sẽ là null.

Đối với người dùng được giám sát, bạn sẽ nhận được những thông tin sau:

• userStatus sẽ là AgeSignalsVerificationStatus.SUPERVISED.
• ageLower sẽ là một số (ví dụ: 13).
• ageUpper sẽ là một số hoặc null (ví dụ: 15).
• mostRecentApprovalDate sẽ là một đối tượng ngày Java (ví dụ: 2026-01-01) hoặc null (nếu không có thay đổi đáng kể nào được phê duyệt).
• installID sẽ là một mã nhận dạng gồm chữ và số do Play tạo (ví dụ: 550e8400-e29b-41d4-a716-446655441111).

Đối với người dùng được giám sát có yêu cầu phê duyệt thay đổi quan trọng đang chờ xử lý, bạn sẽ nhận được thông tin sau:

• userStatus sẽ là AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING.
• ageLower sẽ là một số (ví dụ: 13).
• ageUpper sẽ là một số hoặc null (ví dụ: 15).
• mostRecentApprovalDate sẽ là một đối tượng ngày Java (ví dụ: 2026-01-01) hoặc null (nếu không có thay đổi đáng kể nào được phê duyệt).
• installID sẽ là một mã nhận dạng gồm chữ và số do Play tạo (ví dụ: 550e8400-e29b-41d4-a716-446655441111).

Xử lý mã lỗi API

Nếu ứng dụng của bạn đưa ra Yêu cầu API Play Age Signals và lệnh gọi không thành công, thì ứng dụng sẽ nhận được 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.