Changelog

Data Plan Agent API

كانون الأول (ديسمبر) 2019

1. تم تقديم تعريف واجهة برمجة التطبيقات register CPID الخاصة باتفاقية معالجة البيانات.
2. تمت إضافة اقتراحات حول كيفية إنشاء CPID وتخزينه عندما يطلب العميل CPID جديدًا.
3. تمت إضافة مستندات حول كيفية اختيار CPID لاستخدامه في إرسال الإشعارات.
4. تم توضيح كيفية تحديد الإعدادات المفضّلة للغة المستخدم عندما تطلب أداة GTAF بيانات من "اتفاقية معالجة البيانات" وعندما تطلب "اتفاقية معالجة البيانات" بيانات من أداة GTAF.

أكتوبر 2019

1. يجب طلب معرّف CPID جديد في كل مرة نتواصل فيها مع نقطة نهاية معرّف CPID. ويمكن تحقيق ذلك من خلال إضافة طابع زمني إلى خوارزمية إنشاء CPID.
2. إزالة planLanguage من Offer الذي كان حتى الآن مصنّفًا كحقل مطلوب

أيلول (سبتمبر) 2019

1. تمت إضافة إشعارات بشأن انتهاء صلاحية البيانات، وهي تختلف عن إشعارات التحذير بشأن انتهاء صلاحية البيانات.

تمّوز (يوليو) 2019

1. تم توضيح قيم معرّف العميل المحتملة.
2. تمت إضافة إمكانية تلقّي إشعارات بشأن إعادة شحن الحساب.
3. تخفيف متطلبات إنشاء معرّف CPID من خلال عدم اشتراط إنشاء معرّف جديد في كل مرة يتم فيها استدعاء نقطة نهاية معرّف CPID
4. إضافة مستندات بشأن الردود المختلفة التي تتضمّن أخطاء من GTAF عند طلب Mobile Data Plan Sharing API

حزيران (يونيو) 2019

1. تم تعديل مواصفات واجهة برمجة التطبيقات الخاصة بـ DPA لتتطلّب من شركات النقل قبول _clientid كمعلَمة طلب بحث.
2. تم تعديل واجهة برمجة التطبيقات Mobile Data Plan Sharing API لتسمح لمشغّلي شبكات الجوّال بمشاركة معلومات خطة البيانات الخاصة بمستخدم مع عميل معيّن في Google.
3. قد لا يكون ترتيب ظهور العروض للمستخدم هو نفسه ترتيب تقديم العروض إلى GTAF.
4. قد تشارك GTAF أكثر من 10 خطط مع واجهة مستخدم "خطة بيانات الجوّال".

مايو 2019

1. يجب توفير ExpirationTime ما لم تنتهِ صلاحية الخطة.
2. وفقًا لطلب التعليقات RFC 6749، يجب وضع علامة على token_type كحقل مطلوب في ردّ خادم OAuth.
3. تعرض هذه السمة نوع الإشعارات التي تم إرسالها إلى المستخدم عندما يرسل مشغّل شبكة الجوّال حالة خطة إلى GTAF.

نيسان (أبريل) 2019

1. يجب توفير AccountInfo للمشتركين في خطط الدفع المُسبق.
2. عدِّل طريقة إنشاء CPID المقترَحة لتضمين اللغة في النص العادي عند إنشاء CPID.
3. تمت إزالة إمكانية استخدام moreInfoUrl وoperatorLogoUrl وpurchaseUrl من العروض. لم تكن هذه الحقول متوافقة مع واجهة مستخدم خطة بيانات الجوّال. التغيير متوافق مع الإصدارات القديمة.
4. تمت إضافة إمكانية إرسال إشعارات عندما ينفق المستخدم رصيد الحساب باستخدام البيانات في حالة الدفع حسب الاستخدام.
5. تمت إزالة إمكانية استخدام فترات العمل المرنة من وحدات الخطة. التغيير متوافق مع الإصدارات القديمة. لذلك، إذا كان المشغّل يرسل إلينا فترات زمنية مرنة، سيتم قبول الردّ.

آذار (مارس) 2019

1. أزِل offerInfo.promoMessage من مجموعة الحقول المطلوبة. لا تستخدم منصة MDP هذا الحقل عند عرض العروض الترويجية للمستخدمين.
2. إصلاح خطأ في المستندات يشير إلى أنّه يجب ترميز معرّف الشريك باستخدام نظام ترميز عناوين URL بدلاً من ذلك، تشفّر GTAF معرّف CPID وفقًا RFC2396.
3. تمت إضافة متطلبات الإشعارات الفورية.

شباط (فبراير) 2019

1. تمت إزالة إمكانية مشاركة PlanOffer مع Google باستخدام واجهة برمجة التطبيقات الخاصة بمشاركة خطة البيانات.

كانون الثاني (يناير) 2019

1. تمت إضافة دليل لتعديل إعدادات مشغّل شبكة الجوّال باستخدام بوابة مقدّم خدمة الإنترنت.
2. تمت إضافة دليل لاستخدام بروتوكول OAuth لواجهة برمجة التطبيقات Data Plan Agent API.
3. تمت إعادة تسمية دليل دمج Mobile Data Plan Sharing API وإعادة تنظيمه.

تشرين الثاني (نوفمبر) 2018

1. تمت إضافة إشعارات لتفعيل الخطة.
2. تمّت إضافة إمكانية استخدام فئة حركة مرور لوحدة خطة APP_STORE.

أيلول (سبتمبر) 2018

1. تمت إضافة واجهة برمجة تطبيقات لإبلاغ المشغّلين بموافقة المستخدم.
2. تمت إضافة إمكانية استخدام الخطط التي يتم تجديد حصتها بشكل دوري في PlanModule و Offer.
3. تمت إضافة إشعارات انتهاء الصلاحية.
4. تمت إعادة تسمية PlanModuleState إلى PlanState. هذا مجرّد تعديل على المستندات، ولا يفترض أن يؤثر في المشغّلين.

آب (أغسطس) 2018

1. أضفنا إمكانية أن تحدّد شركات النقل رصيد الحساب كجزء من PlanStatus.

حزيران (يونيو) 2018

1. تمت إزالة طريقتَي التعديل والحصول على حالة الخطة وعروضها.
2. يسمح بتعبئة مستوى الرصيد التقريبي في الوقت نفسه الذي يتم فيه تعبئة رصيد البايت أو رصيد الوقت.
3. تمت إضافة نوع الاتصال إلى عرض.
4. تمت إضافة حقل حالة وحدة الخطة إلى PlanModule للسماح لمشغّل شبكة الجوّال بتحديد الخطط التي اشتراها المستخدم ولكن لم يتم تفعيلها بعد. هذا الحقل غير مطلوب.
5. تمت إعادة تسمية DataPlan إلى خطة. هذا مجرّد تعديل على المستندات، وليس تغييرًا في السلوك.
6. تمت إضافة الحقل formOfPayment إلى PlanOffer للسماح للمشغّل بتحديد طريقة تحصيل الرسوم من المستخدم مقابل عملية الشراء. يكون الإعداد التلقائي هو الخصم من رصيد الخطة.

أيار (مايو) 2018

1. تم تعديل ردّ CPID للحفاظ على توافق الردّ مع الإصدارات السابقة.
2. تمت إضافة عنوان إلى PlanStatus. سيتم استخدام العنوان لتعبئة العنوان في واجهة مستخدم الإعدادات.
3. تمت إضافة اسم الوحدة النمطية والبايتات المستخدَمة إلى PlanModule.
4. تمت إضافة عملية ردّ على طلب الشراء إلى GTAF.

آذار (مارس) 2018

يتضمّن هذا التحديث التغييرات التالية على Data Plan Agent API. تتعلّق هذه التغييرات بالإصدار 4.2 من Data Plan API المستضاف هنا.

1. تم إيقاف طلبات البيانات التالية من واجهة برمجة التطبيقات:
   1. طلب البحث عن حساب المستخدم (DPA_URL/{data_plan_key_string}/account).
   2. طلب البحث عن الخطط التي تم شراؤها (DPA_URL/{data_plan_key_string}/purchasedPlans).
2. تغيير عنوان URL الذي نطلبه لمعرفة حالة خطة البيانات يمكنك الاطّلاع على وصف عنوان URL الجديد هنا. من المتوقّع أن تعرض "هيئة حماية البيانات" مثيلاً من PlanStatus.
3. تغيير عنوان URL الذي نستخدمه لعرض عروض الخطط يمكنك الاطّلاع على وصف عنوان URL الجديد هنا. من المتوقّع أن تعرض DPA مثيلاً من PlanOffer.
4. تغيير نص الطلب المُرسَل إلى "اتفاقية معالجة البيانات" عند شراء خطة يُرجى العِلم أنّ طلب البيانات من واجهة برمجة التطبيقات هو نفسه. يحتوي نص الطلب الآن على مثال TransactionRequest. يُرجى العِلم أنّه تمت إزالة مستوى من التداخل مقارنةً بالإصدار السابق من واجهة برمجة التطبيقات.
5. تغيّر الردّ على طلب شراء. نستفيد من نوع العملة المحدّد بواسطة Google protobuf. في حال نجاح عملية الشراء، نتوقّع أن يحتوي نص الاستجابة على مثال TransactionResponse.
6. في حال عدم تحديد plan_id، يجب أن تعرض واجهة برمجة التطبيقات الخاصة بتحديد الأهلية جميع خطط البيانات التي يكون المستخدم مؤهلاً لها. كانت هذه الخطوة اختيارية في السابق.
7. تضيف هذه السمة نقطة نهاية لتسجيل أرقام MSISDN في إطار GTAF من أجل تسجيل أرقام MSISDN لتلقّي الإشعارات من خلال DPA.

Google Mobile Data Plan Sharing API

آذار (مارس) 2018

يتضمّن هذا التحديث التغييرات التالية على واجهة برمجة التطبيقات Google Mobile Data Plan Sharing API:

1. تضيف هذه الواجهة طلبات جديدة إلى واجهة برمجة التطبيقات تتيح للمشغّل إرسال معلومات عروض الترقية إلى GTAF ليتم إرسالها إلى أجهزة المستخدمين. تتيح هذه الطلبات الجديدة للمشغّل إرسال العروض إلى Google.
2. تضيف هذه السمة حقل "وقت آخر تعديل" إلى PlanGroup.
3. يزيل حقل النسبة المئوية لرصيد البيانات من فترة الوقت المرنة.