نظرة عامة
تسمح أيضًا واجهة برمجة التطبيقات الخاصة بمشاركة خطة بيانات Google للأجهزة الجوّالة لمشغّل بإرسال إشعارات إلى المستخدم من خلال إرسال PlanStatus.
تتيح واجهة برمجة التطبيقات حاليًا استخدام 7 أنواع من الإشعارات.
- الرصيد المنخفض: عندما يتم ضبط 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 واحد، سيتم إرسال عدد متساوٍ من الإشعارات إلى المستخدم.
المتطلّبات
يجب أن يحتوي الإشعار PlanStatus على أكبر قدر ممكن من المعلومات حول خطة الجوّال للمستخدم. بالنسبة إلى كل نوع من أنواع الإشعارات، تحدّد واجهة برمجة التطبيقات لمشاركة خطة البيانات أيضًا مجموعة من الحقول المطلوبة لإنشاء نص الإشعار. يجب أن يتضمّن عامل التشغيل هذه الحقول في حالة حالة الإشعار.
| إشعار | حقول مطلوبة |
|---|---|
| الرصيد منخفض | بلا وحدة. |
| نفدت البيانات | اسم الوحدة |
| تحذير انتهاء صلاحية البيانات | PlanUnit.moduleName، وPlanUnit.expirationTime |
| تفعيل الخطة | اسم الوحدة |
| انتهاء صلاحية البيانات | اسم الوحدة |