Обзор
Google Mobile Data Plan Sharing API также позволяет оператору отправлять уведомления пользователю, отправляя PlanStatus .
В настоящее время API поддерживает следующие уведомления:
- Низкий баланс : когда для PlanModule .coarseBalanceLevel установлено значение LOW_QUOTA.
- Out of Data : когда для PlanModule .coarseBalanceLevel установлено значение OUT_OF_DATA . Если в дополнение к этому для параметра PlanModule .overUsagePolicy установлено значение PAY_AS_YOU_GO, то пользователь будет уведомлен о переходе в режим оплаты по мере использования.
- Предупреждение об истечении срока действия данных : когда PlanModule .planModuleState имеет значение EXPIRING_SOON
- Активация плана : когда PlanModule .planModuleState имеет значение NEWLY_ACTIVE
- Pay as you go : когда AccountInfo .payAsYouGoCharge заполняется суммой, которую потратил пользователь. Если accountBalance заполнен, то в уведомлении отображается оставшийся баланс на счете.
- Пополнение счета : при заполнении AccountInfo .accountTopUp и AccountInfo .accountBalance. Оба эти поля необходимы для отправки пользователю уведомления о пополнении счета. Если единицы и нано в AccountInfo .accountTopUp установлены равными нулю, то сумма пополнения не включается в уведомление.
- Срок действия данных : когда PlanModule .planModuleState имеет значение EXPIRED . Это для планов, срок действия которых уже истек.
Одно уведомление отправляется пользователю для каждого набора полей. Если в одном PlanStatus задано несколько coarseBalanceLevel или planModuleState , пользователю будет отправлено равное количество уведомлений.
Статус плана, который запускает уведомление, отправляется на пользовательское устройство для обновления кеша на устройстве. Это улучшает взаимодействие с пользователем, показывая недавний статус плана, когда пользователь нажимает на уведомление. Если статус плана, используемый для отправки уведомления, не является полным и не должен отображаться пользователю, то оператор связи ДОЛЖЕН установить для UiCompatibility значение UI_INCOMPATIBLE .
Требования
Уведомление PlanStatus СЛЕДУЕТ содержать как можно больше информации о мобильном плане пользователя. Для каждого типа уведомлений API совместного использования планов данных также определяет минимальный набор полей, необходимых для создания текста уведомления. Оператор ДОЛЖЕН включать эти поля в уведомление PlanStatus.
| Уведомление | Обязательные поля |
|---|---|
| Низкий баланс | PlanModule.moduleName, PlanModule.byteBalance.remainingBytes |
| Нет данных | PlanModule.moduleName |
| Предупреждение об истечении срока действия данных | PlanModule.moduleName, PlanModule.expirationTime |
| Активация плана | PlanModule.moduleName |
| Плати как сможешь | AccountInfo.payAsYouGoCharge |
| Пополнение счета | AccountInfo.accountTopUp |
| Срок действия данных | PlanModule.moduleName |