תרחישים נוספים לדוגמה

זכאות

צוות GTAF עשוי לשלוח את בקשת הזכאות הבאה כדי לבדוק אם משתמש זכאי לרכוש תוכנית.

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

חשוב לשים לב ש-planId הוא המזהה הייחודי של התוכנית שניתן להשתמש בו כדי לרכוש את התוכנית בשם המשתמש (מידע נוסף זמין בקטע רכישת נתונים). אם לא מציינים את planId, ה-DPA חייב להחזיר את כל התוכניות שנרכשו על ידי המשתמש.

מקרי שגיאה מכילים את התשובות הצפויות מ-DPA במקרה של שגיאה. בנוסף, ה-DPA יחזיר שגיאה במקרה הבא:

• הרשות להגנה על מידע (DPA) מחזירה קוד שגיאה 400 גרועה של בקשה, המציין ש-GTAF לא תקין.planId.
• הרשות להגנה על מידע (DPA) מחזירה קוד שגיאה 409 CONFLICT שמעיד על כך ש-planId לא תואם לתוכנית הנתונים של המשתמש.

אם לא, ה-DPA יחזיר תגובה של 200 OK. הפורמט של כשירות לעמידה בקריטריונים הוא:

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

כשהבקשה תכלול planId, התגובה תכלול רק את התוכנית הזו. אחרת, הרשימה תכלול את כל התוכניות שהמשתמשים יכולים לרכוש. אם planId ריק ו-DPA לא תומך בהחזרת רשימת התוכניות העומדות בדרישות, הוא חייב להחזיר שגיאת 400 בקשה שגויה.

חוויות Android 5G

GTAF מאפשר לספקים לשתף סטטוס מדידה לפי סוג החיבור למנויים. המידע יכול להישלף מדי פעם על ידי GTAF או שספק השירות יכול לדחוף את המידע לפי גורמים פנימיים.

משיכת API

המכשיר יכול לשלוף את נתוני המטרייה באמצעות GTAF באמצעות:

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

הערה: DPA (סוכן תוכניות נתונים) מייצג שרת GW API או שרת הרשאות ברשת של הספק.

userKey הוא אסימון האימות שנוצר במהלך שלב האימות הראשוני, כפי שמוגדר כאן.

client_id הוא AndroidSystemInfo

הסטטוס מטריות מסופק כ-ENUM

הרשות להגנה על מידע (DPA) תחזיר תגובה 200 סבירה ותכלול planInfoPerClient טיפול בשגיאות ב-DPA מוגדר כאן

במודל ה-GFF, GTAF פועל כלקוח ומאמת את אישור ה-SSL של DPA&#39. 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. את הבקשות הנכנסות יש לאמת כחשבון שירות שנכלל בפורטל ה-ISP עבור ה-ASN שמייצג ה-DPA. בנוסף, אפשר לעיין כאן במדריך לאינטגרציה.