שימוש ב-Play Age Signals API (בטא)

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

אותות הגיל נשמרים על ידי Google Play במכשיר עבור כל משתמש. כשמשתמשים עם חשבון Google מפוקח עוברים לקבוצת גיל חדשה, מערכת Google Play מעדכנת באופן אוטומטי את אותות הגיל ששמורים במטמון לגבי המשתמשים האלה תוך שבועיים עד 8 שבועות אחרי יום ההולדת שלהם.

(אופציונלי) קבלת טווחי גילאים בהתאמה אישית

טווחי הגילאים ש-API מחזיר כברירת מחדל באזורים ובסמכויות שיפוט רלוונטיים הם 0-12, ‏13-15, ‏16-17 ו-18 ומעלה. יכול להיות שהם ישתנו בעתיד בהתאם לדרישות המקומיות.

לחלופין, כדי להתאים אישית את טווחי הגילאים בהתאם לדרישות הגיל המינימלי באפליקציה, אפשר לציין את דרישות הגיל המינימלי באפליקציה בדף אותות גיל ב-Google Play Console. ‫Age Signals API מחזיר את טווחי הגילאים המותאמים אישית. לדוגמה, אם מציינים את הגילאים המינימליים 9, ‏15 ו-17, משתמש בן 14 ייכלל בטווח הגילאים 10-15. הגילים המינימליים צריכים להיות בהפרש של שנתיים לפחות, ואפשר לשנות אותם פעם בשנה.

כדי להתאים אישית את טווחי הגילאים ש-Age Signals API מחזיר, אפשר לציין דרישות גיל מינימלי באפליקציה:

1. עוברים לדף אותות גיל ב-Play Console.
2. בכרטיסייה הגילאים המינימליים לשימוש באפליקציה, מזינים עד שלוש דרישות גיל מינימלי לשימוש באפליקציה.
3. לוחצים על שמירה.

תשובות לאותות גיל

התשובה של Play Age Signals API (בטא) כוללת את השדות והערכים הבאים. הערכים עשויים להשתנות. אם רוצים לקבל את הערכים העדכניים ביותר, צריך לשלוח בקשה לתשובת API כשהאפליקציה נפתחת. באחריותכם לספק חוויות שמתאימות לגיל באמצעות האותות האלה.

תגובות לדוגמה

אם המשתמש מאומת, תקבלו את הפרטים הבאים:

• המחיר של userStatus יהיה AgeSignalsVerificationStatus.VERIFIED.
• שאר שדות התשובה יהיו ריקים.

משתמש בפיקוח יקבל את ההודעות הבאות:

• המחיר של userStatus יהיה AgeSignalsVerificationStatus.SUPERVISED.
• הערך ageLower יהיה מספר (למשל, 13).
• הערך ageUpper יהיה מספר (למשל, 15).
• ‫mostRecentApprovalDate יהיה אובייקט תאריך של Java (לדוגמה, 2026-01-01) או ריק (אם לא אושר שינוי משמעותי).
• ‫installID יהיה מזהה אלפאנומרי שנוצר על ידי Play (לדוגמה, 550e8400-e29b-41d4-a716-446655441111).

אם יש משתמש בפיקוח שהבקשה שלו לאישור שינוי משמעותי נמצאת בהמתנה, תקבלו את ההודעה הבאה:

• המחיר של userStatus יהיה AgeSignalsVerificationStatus.SUPERVISED_APPROVAL_PENDING.
• הערך ageLower יהיה מספר (למשל, 13).
• הערך ageUpper יהיה מספר (למשל, 15).
• ‫mostRecentApprovalDate יהיה אובייקט תאריך של Java (לדוגמה, 2026-01-01) או ריק (אם לא אושר שינוי משמעותי).
• ‫installID יהיה מזהה אלפאנומרי שנוצר על ידי Play (לדוגמה, 550e8400-e29b-41d4-a716-446655441111).

טיפול בקודי שגיאה של API

אם האפליקציה שולחת בקשה ל-Play Age Signals API (בטא) והקריאה נכשלת, האפליקציה מקבלת קוד שגיאה. השגיאות האלה יכולות לקרות בגלל מגוון סיבות, כמו גרסה לא עדכנית של אפליקציית חנות Play.

אסטרטגיה של ניסיון חוזר

במקרים שבהם המשתמש נמצא בסשן, מומלץ להטמיע אסטרטגיה של ניסיון חוזר עם מספר מקסימלי של ניסיונות כתנאי יציאה, כדי שהשגיאה תשבש את חוויית המשתמש כמה שפחות.