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ợ 7 loại thông báo.
- 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ạ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ó trong 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.
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 |
| Ngày hết hạn của dữ liệu | PlanModule.moduleName |