نمای کلی
Google Mobile Data Plan Sharing API همچنین به اپراتور اجازه می‌دهد تا با فشار دادن یک PlanStatus ، اعلان‌ها را برای کاربر ارسال کند.
API در حال حاضر از اعلان‌های زیر پشتیبانی می‌کند:
- Low Balance : زمانی که PlanModule.coarseBalanceLevel روی LOW_QUOTA تنظیم شده است
- خارج از داده : زمانی که 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 با مبلغی که کاربر خرج کرده است پر شود. اگر موجودی حساب پر شده باشد، اعلان موجودی باقی مانده در حساب را نشان می دهد.
- شارژ حساب : زمانی که AccountInfo .accountTopUp و AccountInfo .accountBalance پر می شوند. هر دو این فیلدها برای ارسال اعلان شارژ حساب به کاربر الزامی هستند. اگر واحدها و نانوها در AccountInfo .accountTopUp روی صفر تنظیم شده باشند، مقدار شارژ در اعلان لحاظ نمی شود.
- انقضای داده : زمانی که PlanModule.planModuleState روی EXPIRED تنظیم شده باشد. این برای طرح هایی است که قبلاً منقضی شده اند.
برای هر مجموعه فیلد یک اعلان برای کاربر ارسال می شود. اگر چندین فیلد coarseBalanceLevel یا planModuleState در یک PlanStatus تنظیم شده باشد، تعداد مساوی اعلان برای کاربر ارسال خواهد شد.
وضعیت طرح که اعلان را فعال می کند به دستگاه کاربر ارسال می شود تا حافظه پنهان دستگاه به روز شود. این کار با نمایش وضعیت طرح اخیر هنگامی که کاربر روی اعلان کلیک می کند، تجربه کاربر را بهبود می بخشد. اگر وضعیت طرح مورد استفاده برای ارسال اعلان کامل نیست و نباید به کاربر نشان داده شود، شرکت مخابراتی باید UiCompatibility را روی UI_INCOMPATIBLE تنظیم کند.
الزامات
یک اعلان PlanStatus باید تا حد امکان حاوی اطلاعات بیشتری در مورد طرح تلفن همراه کاربر باشد. برای هر نوع اعلان، Data Plan Sharing API نیز حداقل مجموعه ای از فیلدها را تعریف می کند که برای ساخت متن اعلان لازم است. اپراتور باید این فیلدها را در اعلان PlanStatus قرار دهد.
| اطلاع رسانی | فیلدهای مورد نیاز |
|---|---|
| تعادل پایین | PlanModule.moduleName، PlanModule.byteBalance.remainingBytes |
| خارج از داده | PlanModule.moduleName |
| هشدار انقضای داده ها | PlanModule.moduleName، PlanModule.expirationTime |
| فعال سازی طرح | PlanModule.moduleName |
| همانطور که می روید پرداخت کنید | AccountInfo.payAsYouGoCharge |
| شارژ حساب | AccountInfo.accountTopUp |
| انقضای داده | PlanModule.moduleName |