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

זכאות

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

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

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

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

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

אחרת, הרשות להגנה על מידע תחזיר תשובה 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 ב-Android

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

Pull API

המכשיר יכול לאחזר את פרטי החיוב לפי נפח נתונים דרך GTAF באמצעות הפעולות הבאות:

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

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

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

client_id הוא AndroidSystemInfo

הסטטוס של Meteredness מסופק כ-ENUM

ה-DPA מחזיר תגובה של 200 OK וכולל את planInfoPerClient הטיפול בשגיאות ב-DPA מוגדר כאן

במודל המשיכה, GTAF פועל כלקוח ומאמת את אישור ה-SSL של DPA. GTAF מאמת את עצמו ב-DPA באמצעות תהליך OAuth שמוגדר כאן.

Push API

הספק יכול גם לשלוח את פרטי השימוש לפי תעריף על סמך אירוע הפעלה, למשל שינוי של תוכנית מחירים וכו'.

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

ה-DPA יכלול את planInfoPerClient בגוף ההודעה. תגובות השגיאה מ-GTAF מוגדרות כאן

במצב הדחיפה, GTAF מאמת בקשות נכנסות מ-DPA באמצעות שרת OAuth2 של Google Cloud. הבקשות הנכנסות צריכות להיות מאומתות כחשבון שירות שנכלל ברשימת ההיתרים בפורטל ספקי האינטרנט עבור מספר ה-ASN שמייצג ה-DPA. פרטים נוספים זמינים גם במדריך ההטמעה כאן.