نظرة عامة
تتيح واجهة Google Mobile Data Plan Sharing API أيضًا للمشغّل إرسال إشعارات إلى المستخدم من خلال إرسال PlanStatus.
تتيح واجهة برمجة التطبيقات حاليًا الإشعارات التالية:
- الرصيد منخفض: عندما يتم ضبط 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 على صفر، لن يتم تضمين مبلغ الرصيد المضاف في الإشعار.
- انتهاء صلاحية البيانات: عند ضبط 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 |