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