موارد استفاده اضافی

شایستگی

GTAF ممکن است درخواست واجد شرایط بودن زیر را برای بررسی اینکه آیا یک کاربر واجد شرایط خرید یک طرح است یا خیر صادر کند.

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

توجه داشته باشید که planId شناسه منحصربه‌فردی برای طرح است که می‌توان از آن برای خرید طرح از طرف کاربر استفاده کرد (به خرید داده مراجعه کنید). اگر planId مشخص نشده باشد، DPA باید همه طرح های قابل خرید توسط آن کاربر را برگرداند.

موارد خطا پاسخ های مورد انتظار از DPA را در صورت بروز خطا فهرست می کند. علاوه بر این، DPA باید یک خطا در موارد خطای زیر برگرداند:

• DPA کد خطای 400 BAD REQUEST را برمی گرداند که به GTAF نشان می دهد که planId نامعتبر است.
• DPA یک کد خطای CONFLICT 409 را برمی گرداند که نشان می دهد planId با طرح داده کاربر ناسازگار است.

در غیر این صورت، DPA باید یک پاسخ 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 را برگرداند.

تجربه های اندروید 5G

GTAF اپراتورها را قادر می سازد تا وضعیت اندازه گیری را در هر نوع اتصال برای مشترکین به اشتراک بگذارند. اطلاعات می تواند به صورت دوره ای توسط GTAF کشیده شود یا اپراتورها می توانند اطلاعات را بر اساس محرک های داخلی فشار دهند.

API را بکشید

دستگاه می تواند اطلاعات اندازه گیری را از طریق GTAF با استفاده از موارد زیر بکشد:

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

توجه داشته باشید که DPA (نماینده طرح داده) یک API GW یا سرور حق را در شبکه شرکت مخابراتی نشان می دهد.

userKey نشانه احراز هویت است که در مرحله احراز هویت اولیه همانطور که در اینجا تعریف شده است ایجاد شده است.

client_id AndroidSystemInfo است

وضعیت اندازه گیری به صورت ENUM ارائه می شود

DPA باید 200 پاسخ OK را برگرداند و شامل رسیدگی به خطا planInfoPerClient برای DPA در اینجا تعریف شده است.

در مدل کششی، GTAF به عنوان یک کلاینت عمل می کند و گواهی SSL DPA را تایید می کند. GTAF با استفاده از روش OAuth که در اینجا تعریف شده است خود را به DPA احراز هویت می کند.

Push API

شرکت مخابراتی همچنین می‌تواند اطلاعات اندازه‌گیری را با استفاده از موارد زیر بر اساس یک رویداد محرک (مانند تغییر طرح قیمت و غیره) فشار دهد.

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

DPA باید planInfoPerClient را در متن پیام قرار دهد. پاسخ های خطا از GTAF در اینجا تعریف شده است

در حالت فشار، GTAF درخواست‌های دریافتی از DPA را با استفاده از سرور Google Cloud OAuth2 احراز هویت می‌کند. درخواست‌های دریافتی باید به‌عنوان یک حساب سرویس که در پورتال ISP برای ASN که DPA نمایندگی می‌کند در لیست سفید قرار گرفته است، احراز هویت شوند. همچنین برای جزئیات بیشتر به راهنمای ادغام اینجا مراجعه کنید.