개요
Google 모바일 데이터 요금제 공유 API를 사용하면 운영자가 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의 단위와 나노가 0으로 설정된 경우 충전 금액이 알림에 포함되지 않습니다.
- 데이터 만료: PlanModule.planModuleState가 EXPIRED로 설정된 경우입니다. 이미 만료된 요금제에 적용됩니다.
각 필드 세트에 대해 사용자에게 하나의 알림이 전송됩니다. 단일 PlanStatus에 여러 coarseBalanceLevel 또는 planModuleState 필드가 설정된 경우 사용자에게 동일한 수의 알림이 전송됩니다.
알림을 트리거하는 계획 상태가 사용자 기기로 전송되어 기기 내 캐시를 업데이트합니다. 이렇게 하면 사용자가 알림을 클릭할 때 최근 요금제 상태가 표시되어 사용자 환경이 개선됩니다. 알림 전송에 사용된 계획 상태가 완전하지 않고 사용자에게 표시되지 않아야 하는 경우 이동통신사는 UiCompatibility를 UI_INCOMPATIBLE로 설정해야 합니다(MUST).
요구사항
알림 PlanStatus에는 사용자의 모바일 요금제에 관한 정보를 최대한 많이 포함해야 합니다(SHOULD). 각 알림 유형에 대해 데이터 요금제 공유 API는 알림 텍스트를 빌드하는 데 필요한 최소 필드 집합도 정의합니다. 운영자는 알림 PlanStatus에 이러한 필드를 포함해야 합니다(MUST).
| 알림 | 필수 입력란 |
|---|---|
| 잔액 부족 | PlanModule.moduleName, PlanModule.byteBalance.remainingBytes |
| 데이터 없음 | PlanModule.moduleName |
| 데이터 만료 경고 | PlanModule.moduleName, PlanModule.expirationTime |
| 요금제 활성화 | PlanModule.moduleName |
| 사용한 만큼만 지불 | AccountInfo.payAsYouGoCharge |
| 계정 충전 | AccountInfo.accountTopUp |
| 데이터 만료 | PlanModule.moduleName |