تغییرات

Data Plan Agent API

دسامبر 2019

  1. تعریف CPID API رجیستر را برای DPA برای پیاده سازی معرفی کرد.
  2. پیشنهادهایی برای نحوه تولید CPID و ذخیره آن هنگام درخواست مشتری CPID جدید اضافه شده است.
  3. اسنادی برای نحوه انتخاب CPID برای استفاده برای ارسال اعلان ها اضافه شده است.
  4. نحوه تعیین تنظیمات برگزیده زبان کاربر هنگامی که GTAF با DPA و زمانی که DPA با GTAF تماس می‌گیرد، مشخص شد.

اکتبر 2019

  1. هر بار که با نقطه پایانی CPID تماس می گیریم، به یک CPID جدید نیاز داریم. این را می توان با افزودن یک مهر زمانی به الگوریتم تولید CPID انجام داد.
  2. planLanguage را از Offer که تاکنون به عنوان فیلد الزامی علامت گذاری شده بود حذف کنید.

سپتامبر 2019

  1. اضافه شدن پشتیبانی از اعلان‌های انقضای داده‌ها، متمایز از اعلان‌های هشدار انقضا.

جولای 2019

  1. مقادیر احتمالی شناسه مشتری را روشن کرد.
  2. پشتیبانی از اعلان های شارژ حساب اضافه شد.
  3. ملزومات تولید CPID راحت از نیاز به یک CPID جدید هر بار که نقطه پایانی CPID فراخوانی می شود.
  4. هنگام فراخوانی Mobile Data Plan Sharing API اسنادی را برای پاسخ‌های خطای مختلف از GTAF اضافه کنید.

ژوئن 2019

  1. مشخصات DPA API به‌روزرسانی شده که شرکت‌های مخابراتی را ملزم می‌کند شناسه _client را به‌عنوان پارامتر جستجو بپذیرند.
  2. API به‌روزرسانی برنامه اشتراک‌گذاری داده تلفن همراه که به شرکت‌های مخابراتی اجازه می‌دهد اطلاعات طرح یک کاربر را برای یک مشتری خاص با Google به اشتراک بگذارند.
  3. ممکن است ترتیبی که پیشنهادها به کاربر نشان داده می شود با ترتیب ارائه پیشنهادها به GTAF نباشد.
  4. GTAF ممکن است بیش از 10 طرح را با رابط کاربری Mobile Data Plan به اشتراک بگذارد.

می 2019

  1. ExpirationTime مورد نیاز است مگر اینکه طرح منقضی نشود.
  2. در RFC 6749، token_type را به عنوان مورد نیاز در پاسخ سرور OAuth علامت بزنید.
  3. هنگامی که شرکت مخابراتی وضعیت طرح را به GTAF فشار می‌دهد، نوع اعلان‌هایی را که برای کاربر ارسال شده است، برگردانید.

آوریل 2019

  1. AccountInfo برای مشترکین پیش پرداخت لازم است.
  2. روش تولید CPID توصیه شده را به روز کنید تا هنگام ایجاد CPID زبان را در متن ساده قرار دهید.
  3. پشتیبانی از moreInfoUrl، operatorLogoUrl، buyUrl از پیشنهادات حذف شد. این فیلدها توسط رابط کاربری طرح داده تلفن همراه پشتیبانی نمی‌شوند. تغییر با عقب سازگار است.
  4. پشتیبانی برای ارسال اعلان‌ها هنگامی که کاربر در حال خرج کردن موجودی حساب با استفاده از داده‌ها در حالت پرداخت در حین حرکت است، اضافه شد.
  5. پشتیبانی از پنجره های زمان انعطاف پذیر از ماژول های پلان حذف شد. تغییر با عقب سازگار است. بنابراین، اگر یک اپراتور پنجره های زمان انعطاف پذیر را برای ما ارسال کند، پاسخ پذیرفته می شود.

مارس 2019

  1. OfferInfo.promoMessage را از مجموعه فیلدهای ضروری حذف کنید. MDP هنگام نمایش پیشنهادات به کاربران از این فیلد استفاده نمی کند.
  2. رفع اشکال اسناد و مدارک مبنی بر اینکه CPID باید URL رمزگذاری شده باشد. در عوض، GTAF CPID را در هر RFC2396 رمزگذاری می‌کند .
  3. الزامات اضافه شده برای اعلان های فشار.

فوریه 2019

  1. پشتیبانی از اشتراک‌گذاری PlanOffer با Google با استفاده از API اشتراک‌گذاری طرح داده حذف شد.

ژانویه 2019

  1. راهنمای به روز رسانی پیکربندی حامل با استفاده از پورتال ISP اضافه شده است.
  2. راهنمای اجرای OAuth برای Data Plan Agent API اضافه شد.
  3. راهنمای ادغام API به اشتراک گذاری طرح داده تلفن همراه را تغییر نام داد و سازماندهی مجدد کرد.

نوامبر 2018

  1. پشتیبانی از اعلان‌های فعال‌سازی طرح اضافه شد.
  2. پشتیبانی از دسته ترافیک ماژول طرح APP_STORE اضافه شد.

سپتامبر 2018

  1. API برای گزارش رضایت کاربر به اپراتورها اضافه شد.
  2. پشتیبانی اضافه شده برای طرح هایی که به طور دوره ای سهمیه خود را در PlanModule و Offer به روز می کنند.
  3. پشتیبانی از اعلان های انقضا اضافه شده است.
  4. تغییر نام PlanModuleState به PlanState . این یک تغییر مستندات است که نباید اپراتورها را تحت تأثیر قرار دهد.

آگوست 2018

  1. قابلیتی برای شرکت‌های مخابراتی برای تعیین مانده حساب به عنوان بخشی از PlanStatus اضافه شده است.

ژوئن 2018

  1. به‌روزرسانی حذف شد، روش‌هایی برای وضعیت طرح و پیشنهادات طرح دریافت کنید.
  2. هنگامی که تعادل بایت یا تعادل زمانی پر می شود، سطح تعادل درشت مجاز است که همزمان پر شود.
  3. نوع اتصال به یک پیشنهاد اضافه شد.
  4. فیلد حالت ماژول طرح را به PlanModule اضافه کرد تا به اپراتور اجازه دهد طرح هایی را که کاربر خریداری کرده اما هنوز فعال نشده اند را نشان دهد. این یک فیلد الزامی نیست.
  5. DataPlan به Plan تغییر نام داد. این یک تغییر مستندات است که نباید اپراتورها را تحت تأثیر قرار دهد.
  6. فیلد formOfPayment به PlanOffer اضافه شد که به اپراتور اجازه می‌دهد مشخص کند که کاربر برای خرید چگونه هزینه دریافت می‌کند. این به طور پیش فرض از موجودی طرح کسر می شود.

می 2018

  1. پاسخ CPID به روز شد تا پاسخ را با هم سازگار نگه دارد.
  2. عنوان اضافه شده برای یک PlanStatus . عنوان برای پر کردن سرصفحه در رابط کاربری تنظیمات استفاده خواهد شد.
  3. اضافه شدن نام ماژول و بایت های استفاده شده برای PlanModule .
  4. یک تماس پاسخ خرید به GTAF اضافه شد.

مارس 2018

این به‌روزرسانی شامل تغییرات زیر در Data Plan Agent API است. این تغییرات مربوط به Data Plan API نسخه 4.2 است که در اینجا میزبانی شده است.

  1. تماس‌های API زیر را منسوخ می‌کند:
    1. درخواست حساب کاربری (DPA_URL/{data_plan_key_string}/account).
    2. درخواست طرح‌های خریداری‌شده (DPA_URL/{data_plan_key_string}/purchasedPlans).
  2. URL را که برای وضعیت طرح داده فراخوانی می کنیم تغییر می دهد. URL جدید در اینجا توضیح داده شده است. انتظار می رود DPA نمونه ای از PlanStatus را برگرداند.
  3. نشانی اینترنتی را که ما برای پیشنهادات طرح تماس می گیریم تغییر می دهد. URL جدید در اینجا توضیح داده شده است. انتظار می رود DPA یک نمونه از PlanOffer را برگرداند.
  4. متن درخواست ارسال شده به DPA را هنگام خرید طرح تغییر می دهد. توجه داشته باشید که تماس API یکسان است. بدنه درخواست اکنون شامل یک نمونه از TransactionRequest است. به حذف یک سطح از تودرتو در مقایسه با نسخه قبلی API توجه کنید.
  5. پاسخ به درخواست خرید تغییر کرده است. ما از نوع ارز تعریف شده توسط Google protobuf استفاده می کنیم. در پاسخ به خرید موفق، انتظار داریم بدنه پاسخ حاوی نمونه ای از TransactionResponse باشد.
  6. اگر یک plan_id مشخص نشده باشد، API واجد شرایط بودن باید همه طرح‌های داده‌ای را که کاربر واجد شرایط آن است، برگرداند. قبلا این اختیاری بود.
  7. یک نقطه پایانی ثبت MSISDN برای GTAF اضافه می کند تا MSISDN ها را برای اعلان ها با DPA ثبت کند.

Google Mobile Data Plan Sharing API

مارس 2018

این به‌روزرسانی شامل تغییرات زیر در Google Mobile Data Plan Sharing API است:

  1. تماس‌های API جدیدی را معرفی می‌کند که به یک اپراتور اجازه می‌دهد اطلاعات پیشنهاد upsell را به GTAF فشار دهد تا بیشتر به دستگاه‌های کاربر منتقل شود. این تماس‌های جدید به اپراتور اجازه می‌دهد تا پیشنهادات خود را به Google ارسال کند.
  2. آخرین فیلد زمانی به روز شده را در یک PlanGroup معرفی می کند.
  3. فیلد درصد اعتبار داده را از پنجره زمان انعطاف پذیر حذف می کند.