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