개요
Google 모바일 데이터 요금제 공유 API를 사용하면 운영자가 PlanStatus를 푸시하여 사용자에게 알림을 보낼 수도 있습니다.
API는 현재 7가지 유형의 알림을 지원합니다.
- 잔액 부족: 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가 사용자가 지출한 금액으로 채워집니다.
- 계정 충전: AccountInfo.accountTopUp 및 AccountInfo.accountBalance가 채워진 경우 이 두 필드는 사용자에게 계정 충전 알림을 전송하는 데 필요합니다. AccountInfo.accountTopUp의 단위와 나노가 0으로 설정된 경우 충전 금액이 알림에 없습니다.
- 데이터 만료: PlanModule.planModuleState가 EXPIRED로 설정된 경우입니다. 이미 만료된 요금제에 적용됩니다.
각 필드 세트에 대해 사용자에게 하나의 알림이 전송됩니다. 단일 PlanStatus에 여러 coarseBalanceLevel 또는 planModuleState 필드가 설정된 경우 사용자에게 동일한 수의 알림이 전송됩니다.
요구사항
알림 PlanStatus에는 사용자의 모바일 요금제에 관한 정보를 최대한 많이 포함해야 합니다(SHOULD). 각 알림 유형에 대해 데이터 요금제 공유 API는 알림 텍스트를 빌드하는 데 필요한 최소 필드 집합도 정의합니다. 운영자는 알림 PlanStatus에 이러한 필드를 포함해야 합니다(MUST).
| 알림 | 필수 입력란 |
|---|---|
| 잔액 부족 | PlanModule.moduleName, PlanModule.byteBalance.remainingBytes |
| 데이터 없음 | PlanModule.moduleName |
| 데이터 만료 경고 | PlanModule.moduleName, PlanModule.expirationTime |
| 요금제 활성화 | PlanModule.moduleName |
| 데이터 만료 | PlanModule.moduleName |