سجلّ التغييرات

واجهة برمجة تطبيقات وكيل خطة البيانات

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

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

تشرين الأول (أكتوبر) 2019

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

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

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

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

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

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

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

أيار (مايو) 2019

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

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

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

آذار (مارس) 2019

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

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

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

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

1. تمت إضافة دليل لتحديث إعدادات شركة النقل باستخدام بوابة مزوّد خدمة الإنترنت.
2. تمت إضافة دليل لتنفيذ OAuth لواجهة برمجة تطبيقات وكيل خطة البيانات.
3. تمت إعادة تسمية دليل دمج واجهة برمجة التطبيقات لمشاركة خطة بيانات الجوّال وإعادة تنظيمه.

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

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

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

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

آب (أغسطس) 2018

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

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

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

أيار (مايو) 2018

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

آذار (مارس) 2018

ويتضمّن هذا التحديث التغييرات التالية إلى واجهة برمجة تطبيقات وكيل خطة البيانات. ترتبط هذه التغييرات بالإصدار 4.2 من واجهة برمجة التطبيقات لخطة البيانات التي تتم استضافتها هنا.

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

واجهة برمجة تطبيقات مشاركة خطة بيانات الجوّال من Google

آذار (مارس) 2018

ويتضمّن هذا التحديث التغييرات التالية في واجهة برمجة التطبيقات الخاصة بمشاركة خطة Google Data Data:

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