حالات استخدام إضافية

الأهلية

قد تصدر GTAF طلب الأهلية التالي للتحقّق مما إذا كان المستخدم مؤهلاً لشراء خطة.

GET DPA/{userKey}/Eligibility/{planId}?key_type={CPID,MSISDN}

يُرجى العِلم أنّ planId هو المعرّف الفريد للخطة الذي يمكن استخدامه لشراء الخطة نيابةً عن المستخدم (راجِع شراء البيانات). في حال عدم تحديد planId، يجب أن تعرض DPA جميع الخطط التي يمكن للمستخدم شراؤها.

تسرد حالات الأخطاء الردود المتوقّعة من DPA في حال حدوث خطأ. بالإضافة إلى ذلك، يجب أن تعرض DPA خطأ في الحالات التالية:

• تعرض "هيئة حماية البيانات" رمز الخطأ 400 BAD REQUEST الذي يشير إلى GTAF بأنّ planId غير صالح.
• تعرض "اتفاقية معالجة البيانات" رمز الخطأ 409 CONFLICT الذي يشير إلى أنّ planId غير متوافق مع خطة بيانات المستخدم.

بخلاف ذلك، يجب أن تعرض "هيئة حماية البيانات" الرد 200-OK. يكون تنسيق EligibilityResponse الناجح كما يلي:

{
  "eligiblePlans":
  [
   {
    "planId": string,   // Plan identifier. Can be used to
                        // refer to the plan during
                        // offers, etc. (req.)
   }
  ]
}

عندما يتضمّن الطلب planId، لا يتضمّن الردّ سوى هذا الخطة. بخلاف ذلك، تتضمّن القائمة جميع الخطط التي يمكن للمستخدم شراؤها. في حال كانت planId فارغة ولم يكن موفّر DPA يتيح عرض قائمة بالخطط المؤهَّلة، يجب أن يعرض الخطأ 400 BAD REQUEST.

تجارب شبكة الجيل الخامس على Android

تتيح هذه السمة لشركات النقل مشاركة حالة القياس حسب نوع الاتصال مع المشتركين. يمكن أن تسحب أداة GTAF المعلومات بشكل دوري، أو يمكن لمشغّلي شبكات الجوّال إرسال المعلومات استنادًا إلى عوامل داخلية.

Pull API

يمكن للجهاز استرداد معلومات القياس من خلال GTAF باستخدام ما يلي:

GET DPA/{userKey}/planStatus?key_type={userKey}&client_id=AndroidSystemInfo

يُرجى العِلم أنّ DPA (وكيل خطة البيانات) يمثّل خادم Entitlement أو API GW في شبكة مشغّل شبكة الجوّال.

‫userKey هو رمز المصادقة المميز الذي تم إنشاؤه خلال مرحلة المصادقة الأولية كما هو موضّح هنا.

قيمة client_id هي AndroidSystemInfo

يتم تقديم حالة Meteredness كقيمة ENUM

يجب أن يعرض DPA استجابة 200 OK وأن يتضمّن planInfoPerClient يمكنك الاطّلاع على تعريف معالجة الأخطاء في DPA هنا

في نموذج السحب، تعمل أداة GTAF كعميل وتتحقّق من صحة شهادة SSL الخاصة بـ DPA. تُصادق أداة GTAF على نفسها في DPA باستخدام إجراء OAuth المحدّد هنا.

Push API

يمكن لمشغّل شبكة الجوّال أيضًا إرسال معلومات القياس باستخدام ما يلي استنادًا إلى حدث مشغّل، مثل تغيير خطة الأسعار وما إلى ذلك.

POST https://mobiledataplansharing.googleapis.com/v1/operators/12345/clients/AndroidSystemInfo/users/abcdef/planStatus

يجب أن يتضمّن DPA planInfoPerClient في نص الرسالة. يمكنك الاطّلاع هنا على تعريفات ردود الخطأ من GTAF

في وضع الإرسال، تصادق أداة GTAF على الطلبات الواردة من DPA باستخدام خادم Google Cloud OAuth2. يجب أن تتم مصادقة الطلبات الواردة كحساب خدمة تم إدراجه في القائمة البيضاء في بوابة مقدّم خدمة الإنترنت لرقم نظام مستقل (ASN) الذي تمثّله اتفاقية معالجة البيانات. يمكنك أيضًا الرجوع إلى دليل الدمج هنا للاطّلاع على مزيد من التفاصيل.