Tổng quan
Google Mobile Data Plan Sharing API cũng cho phép nhà mạng gửi thông báo cho người dùng bằng cách đẩy một PlanStatus.
API hiện hỗ trợ các thông báo sau:
- Số dư thấp: khi PlanModule.coarseBalanceLevel được đặt thành LOW_QUOTA
- Hết dữ liệu: khi PlanModule.coarseBalanceLevel được đặt thành OUT_OF_DATA. Ngoài ra, nếu PlanModule.overUsagePolicy được đặt thành PAY_AS_YOU_GO, thì người dùng sẽ nhận được thông báo rằng họ sắp chuyển sang chế độ trả tiền theo mức sử dụng.
- Cảnh báo hết hạn dữ liệu: khi PlanModule.planModuleState được đặt thành EXPIRING_SOON
- Kích hoạt gói: khi PlanModule.planModuleState được đặt thành NEWLY_ACTIVE
- Trả theo mức sử 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 sẵn, thì thông báo sẽ cho biết số dư còn lại trong tài khoản.
- Nạp tiền vào tài khoản: khi AccountInfo.accountTopUp và AccountInfo.accountBalance được điền sẵn. Bạn phải điền cả hai trường này để gửi thông báo nạp tiền vào tài khoản cho người dùng. Nếu đơ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.
- Ngày hết hạn của dữ liệu: khi PlanModule.planModuleState được đặt thành EXPIRED. Đây là những kế hoạch đã hết hạn.
Người dùng sẽ nhận được một thông báo cho mỗi bộ trường. Nếu bạn đặt nhiều trường coarseBalanceLevel hoặc planModuleState trong một PlanStatus, thì hệ thống sẽ gửi cho người dùng số lượng thông báo tương ứng.
Trạng thái kế hoạch kích hoạt thông báo sẽ đượ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ị. Điều này giúp cải thiện trải nghiệm người dùng bằng cách cho thấy 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 kế hoạch được dùng để gửi thông báo chưa hoàn tất và không được hiển thị cho người dùng, thì hãng vận chuyển PHẢI đặt UiCompatibility thành UI_INCOMPATIBLE.
Yêu cầu
Thông báo PlanStatus CẦN chứa nhiều thông tin nhất có thể về gói di động của người dùng. Đối với mỗi loại thông báo, Data Plan Sharing API cũng xác định một tập hợp tối thiểu các trường bắt buộc để tạo văn bản thông báo. Nhân viên vận hành PHẢI đưa các trường này vào PlanStatus thông báo.
| Thông báo | Các trường bắt buộc |
|---|---|
| Số dư thấp | PlanModule.moduleName, PlanModule.byteBalance.remainingBytes |
| Hết dữ liệu | PlanModule.moduleName |
| Cảnh báo về việc dữ liệu hết hạn | PlanModule.moduleName, PlanModule.expirationTime |
| Kích hoạt gói | PlanModule.moduleName |
| Chỉ trả tiền cho những gì bạn nhận được | AccountInfo.payAsYouGoCharge |
| Nạp tiền vào tài khoản | AccountInfo.accountTopUp |
| Ngày hết hạn của dữ liệu | PlanModule.moduleName |