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