Tổng quan
API Chia sẻ gói dữ liệu di động của Google cũng cho phép nhà cung cấp dịch vụ gửi thông báo đến người dùng bằng cách đẩy PlanStatus.
API hiện hỗ trợ các thông báo sau:
- Số dư thấp: khi PlanModule.coarseBalanceLevel được đặt thành HIGH_QUOTA
- Hết dữ liệu: khi PlanModule.coarsebalanceLevel được đặt thành OUT_OF_DATA. Ngoài mục này, PlanModule.overUsagePolicy được đặt là PAY_AS_You_GO, thì người dùng sẽ nhận được thông báo rằng họ sắp vào chế độ thanh toán khi bạn chuyển sang chế độ trả tiền.
- Cảnh báo ngày hết hạn dữ liệu: khi PlanModule.planModuleState được đặt thành EXPIRING_SOON
- Kích hoạt kế hoạch: khi PlanModule.planModuleState được đặt thành NEWLY_ACTIVE
- Trả tiền theo mức dùng: khi AccountInfo.payAsYouGoCharge được điền sẵn số tiền mà người dùng đã chi tiêu. Nếu accountbalance được điền, thông báo sẽ hiển thị số dư còn lại trên tài khoản.
- Nạp tiền tài khoản: khi điền sẵn AccountInfo.accountTopUp và AccountInfo.accountWeight. Cả hai trường này đều bắt buộc phải gửi thông báo nạp tiền cho tài khoản cho người dùng. Nếu các đơn vị và nano trong AccountInfo.accountTopUp được đặt thành 0, thì số tiền nạp sẽ không được đưa vào thông báo.
- Hết hạn dữ liệu: khi PlanModule.planModuleState được đặt thành EXPIRED. Yêu cầu này dành cho những gói đã hết hạn.
Hệ thống sẽ gửi một thông báo cho người dùng trong mỗi nhóm trường. Nếu bạn đặt nhiều trường coarseBalanceLevel hoặc planModuleState trong một PlanStatus, thì số lượng thông báo bằng nhau sẽ được gửi đến người dùng.
Trạng thái gói kích hoạt thông báo được gửi đến thiết bị của người dùng để cập nhật bộ nhớ đệm trên thiết bị. Việc này giúp cải thiện trải nghiệm người dùng bằng cách hiển thị trạng thái kế hoạch gần đây khi người dùng nhấp vào thông báo. Nếu trạng thái gói dùng để gửi thông báo chưa hoàn chỉnh và không nên hiển thị cho người dùng, thì nhà mạng PHẢI đặt UiCompatibility thành UI_INCOMPATIBLE.
Yêu cầu
Thông báo PlanStatus PHẢI chứa nhiều thông tin nhất có thể về gói dịch vụ di động của người dùng. Đối với mỗi loại thông báo, API Chia sẻ gói dữ liệu cũng xác định một tập hợp các trường tối thiểu cần thiết để tạo văn bản thông báo. Toán tử PHẢI bao gồm các trường này trong PlanStatus thông báo.
| Thông báo | Các trường bắt buộc |
|---|---|
| Số dư thấp | PlanModule.moduleName, PlanModule.byteWeight.spendBytes |
| Hết dữ liệu | NameModule.moduleName |
| Cảnh báo về thời gian hết hạn của dữ liệu | PlanModule.moduleName, PlanModule.expirationTime |
| Kích hoạt gói | NameModule.moduleName |
| Trả tiền theo mức dùng | AccountInfo.payAsYouGoCharge |
| Nạp tiền vào tài khoản | AccountInfo.accountTopUp |
| Thời hạn dữ liệu | NameModule.moduleName |