如果應用程式發出 Play Age Signals API 要求,但呼叫失敗,應用程式會收到錯誤代碼。造成這些錯誤的原因有很多,例如 Play 商店應用程式版本過舊。
重試策略:在使用者處於工作階段中時,建議您實作重試策略,並以最大重試次數做為結束條件,盡可能避免干擾使用者體驗。
下表列出 Play Age Signals API 的錯誤代碼。
| 程式碼 | 常數 | 說明 | 可重試 |
|---|---|---|---|
| -1 | API_NOT_AVAILABLE | Play Age Signals API 無法使用。裝置上安裝的 Play 商店應用程式版本可能過舊。請使用者更新 Play 商店。 | 是 |
| -2 | PLAY_STORE_NOT_FOUND | 裝置上找不到 Play 商店應用程式。 請使用者安裝或啟用 Play 商店。 | 是 |
| -3 | NETWORK_ERROR | 找不到可用的網路。 請使用者檢查連線狀態。 | 是 |
| -4 | PLAY_SERVICES_NOT_FOUND | Play 服務無法使用或版本過舊。 請使用者安裝、更新或啟用 Play 服務。 | 是 |
| -5 | CANNOT_BIND_TO_SERVICE | 無法與 Play 商店中的服務繫結,原因可能是裝置上安裝的 Play 商店版本過舊,或是裝置記憶體超載。請使用者更新 Play 商店應用程式。 以指數輪詢方式重試。 | 是 |
| -6 | PLAY_STORE_VERSION_OUTDATED | Play 商店應用程式需要更新。 請使用者更新 Play 商店應用程式。 | 是 |
| -7 | PLAY_SERVICES_VERSION_OUTDATED | Play 服務需要更新。請使用者更新 Play 服務。 | 是 |
| -8 | CLIENT_TRANSIENT_ERROR | 用戶端裝置發生暫時性錯誤。 實作重試策略,並以最大重試次數做為結束條件。如果問題仍未解決,請要求使用者稍後再試。 | 是 |
| -9 | APP_NOT_OWNED | 應用程式不是透過 Google Play 安裝。 請使用者從 Google Play 取得您的應用程式。 | 否 |
| -10 | SDK_VERSION_OUTDATED | 系統已不再支援 Play 年齡信號 SDK 版本。 請使用者將應用程式更新至較新版本,該版本須使用新版 Play 年齡信號 SDK。 | 否 |
| -100 | INTERNAL_ERROR | 未知的內部錯誤。 實作重試策略,並以最大重試次數做為結束條件。如果問題仍未解決,請要求使用者稍後再試。如果持續失敗,請與 Google Play 開發人員支援團隊聯絡,並在主旨中加入 Play Age Signals API,盡可能提供詳細的技術資訊 (例如錯誤報告)。 | 否 |