بررسی اجمالی
Google Mobile Data Plan Sharing API همچنین به اپراتور اجازه می‌دهد تا با فشار دادن یک PlanStatus ، اعلان‌ها را برای کاربر ارسال کند.
API در حال حاضر از 7 نوع اعلان پشتیبانی می کند.
- 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 تنظیم شده باشد، تعداد مساوی اعلان برای کاربر ارسال خواهد شد.
الزامات
یک اعلان PlanStatus باید تا حد امکان حاوی اطلاعات بیشتری در مورد طرح تلفن همراه کاربر باشد. برای هر نوع اعلان، Data Plan Sharing API نیز حداقل مجموعه ای از فیلدها را تعریف می کند که برای ساخت متن اعلان لازم است. اپراتور باید این فیلدها را در اعلان PlanStatus قرار دهد.
| اطلاع | فیلدهای مورد نیاز |
|---|---|
| تعادل پایین | PlanModule.moduleName، PlanModule.byteBalance.remainingBytes |
| خارج از داده | PlanModule.moduleName |
| هشدار انقضای داده ها | PlanModule.moduleName، PlanModule.expirationTime |
| فعال سازی طرح | PlanModule.moduleName |
| انقضای داده | PlanModule.moduleName |
بررسی اجمالی
Google Mobile Data Plan Sharing API همچنین به اپراتور اجازه می‌دهد تا با فشار دادن یک PlanStatus ، اعلان‌ها را برای کاربر ارسال کند.
API در حال حاضر از 7 نوع اعلان پشتیبانی می کند.
- 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 تنظیم شده باشد، تعداد مساوی اعلان برای کاربر ارسال خواهد شد.
الزامات
یک اعلان PlanStatus باید تا حد امکان حاوی اطلاعات بیشتری در مورد طرح تلفن همراه کاربر باشد. برای هر نوع اعلان، Data Plan Sharing API نیز حداقل مجموعه ای از فیلدها را تعریف می کند که برای ساخت متن اعلان لازم است. اپراتور باید این فیلدها را در اعلان PlanStatus قرار دهد.
| اطلاع | فیلدهای مورد نیاز |
|---|---|
| تعادل پایین | PlanModule.moduleName، PlanModule.byteBalance.remainingBytes |
| خارج از داده | PlanModule.moduleName |
| هشدار انقضای داده ها | PlanModule.moduleName، PlanModule.expirationTime |
| فعال سازی طرح | PlanModule.moduleName |
| انقضای داده | PlanModule.moduleName |