نظرة عامة
تسمح أيضًا واجهة برمجة التطبيقات الخاصة بمشاركة خطة بيانات Google للأجهزة الجوّالة لمشغّل بإرسال إشعارات إلى المستخدم من خلال إرسال PlanStatus.
تتيح واجهة برمجة التطبيقات حاليًا الإشعارات التالية:
- الرصيد المنخفض: عندما يتم ضبط PlanUnit.coarse BalanceLevel LOW_حصة
- خارج البيانات: عند ضبط الخاصية PlanUnit.coarse BalanceLevel على OUT_OF_DATA. بالإضافة إلى ذلك، تم ضبط PlanUnit.overUsagePolicy على PAY_AS_YOU_GO، سيتم إشعار المستخدم بأنه على وشك الدخول إلى وضع الدفع أثناء التنقل.
- تحذير بسبب انتهاء صلاحية البيانات: عند ضبط PlanUnit.PlanUnitState على expIRING_SOON
- تفعيل الخطة: عند ضبط الخاصية PlanUnit.PlanUnitState على القيمة NEWLY_ACTIVE
- الدفع حسب الاستخدام: عندما تتم تعبئة AccountInfo.payAsYouGoCharge بالمبلغ الذي أنفقته المستخدم. في حال ملء رصيد الحساب، سيعرض الإشعار الرصيد المتبقي في الحساب.
- إضافة رصيد إلى الحساب: عند تعبئة AccountInfo.accountTopUp وAccountInfo.account Balance. يجب ملء هذين الحقلين لإرسال إشعار لإضافة الرصيد إلى الحساب. إذا تم ضبط الوحدات ونافورات الحساب في AccountInfo.accountTopUp، على صفر، لا يتم تضمين مبلغ إضافة الرصيد في الإشعار.
- انتهاء صلاحية البيانات: عند ضبط PlanUnit.PlanUnitState على انتهت الصلاحية. هذا مُخطط مخصص للخطط التي انتهت صلاحيتها بالفعل.
يتم إرسال إشعار واحد إلى المستخدم لكل مجموعة حقول. في حال ضبط حقلَين
coarseBalanceLevel أو planModuleState في حقل
PlanStatus واحد، سيتم إرسال عدد متساوٍ من الإشعارات إلى المستخدم.
يتم إرسال حالة الخطة التي تؤدي إلى إرسال الإشعار إلى جهاز المستخدم لتعديل
ذاكرة التخزين المؤقت على الجهاز. يساهم ذلك في تحسين تجربة المستخدم من خلال عرض حالة الخطة الأخيرة عند نقر المستخدم على الإشعار. إذا كانت حالة الخطة المستخدمة
لإرسال إشعار غير مكتملة ولا يجب عرضها للمستخدم، يجب أن يضبط
مشغّل شبكة الجوّال طريقة
التوافق مع الاستخدام
على UI_INCOMPATIBLE.
المتطلّبات
يجب أن يحتوي الإشعار PlanStatus على أكبر قدر ممكن من المعلومات حول خطة الجوّال للمستخدم. بالنسبة إلى كل نوع من أنواع الإشعارات، تحدّد واجهة برمجة التطبيقات لمشاركة خطة البيانات أيضًا مجموعة من الحقول المطلوبة لإنشاء نص الإشعار. يجب أن يتضمّن عامل التشغيل هذه الحقول في حالة حالة الإشعار.
| إشعار | حقول مطلوبة |
|---|---|
| الرصيد منخفض | بلا وحدة. |
| نفدت البيانات | اسم الوحدة |
| تحذير انتهاء صلاحية البيانات | PlanUnit.moduleName، وPlanUnit.expirationTime |
| تفعيل الخطة | اسم الوحدة |
| الدفع حسب الاستخدام | معلومات الحساب.PayAsYouGoCharge |
| رصيد الحساب | AccountInfo.accountTopUp |
| انتهاء صلاحية البيانات | اسم الوحدة |