יומן שינויים

Data Plan Agent API

דצמבר 2019

1. הוספנו הגדרה של API‏ register CPID ל-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. הוספת תיעוד לתגובות שגיאה שונות מ-GTAF כשמתקשרים אל Mobile Data Plan Sharing API.

יוני 2019

1. עודכן מפרט ה-API של DPA, ועכשיו נדרש מספקי הסלולר לקבל _clientid כפרמטר של שאילתה.
2. ‫Mobile Data Plan Sharing 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 ו-purchaseUrl ממבצעים. השדות האלה לא נתמכו בממשק המשתמש של חבילת הגלישה לנייד. השינוי תואם לאחור.
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. שינינו את השם של מדריך השילוב של Mobile Data Plan Sharing API וארגנו אותו מחדש.

נובמבר 2018

1. הוספנו תמיכה בהתראות על הפעלת תוכנית.
2. הוספנו תמיכה בקטגוריית תנועה של מודול תוכנית APP_STORE.

ספטמבר 2018

1. הוספנו API לדיווח על הסכמת משתמשים למפעילים.
2. נוספה תמיכה בתוכניות שבהן המכסה מתעדכן מעת לעת ב-PlanModule וב-Offer.
3. הוספנו תמיכה בהתראות על תפוגה.
4. השם PlanModuleState שונה ל-PlanState. זהו שינוי בתיעוד שלא אמור להשפיע על מפעילי רשתות.

אוגוסט 2018

1. נוספה אפשרות לחברות תובלה לציין את יתרת החשבון כחלק מ-PlanStatus.

יוני 2018

1. הוסרו עדכונים, שיטות לקבלת סטטוס התוכנית ומבצעים על תוכניות.
2. אפשר לאכלס את רמת היתרה המשוערת בו-זמנית עם אכלוס היתרה בבייט או היתרה בזמן.
3. נוסף סוג חיבור למבצע.
4. הוספנו את השדה plan module state אל 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 שאליה אנחנו מתקשרים כדי להציג הצעות לתוכניות. כאן מפורטת כתובת ה-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 שמאפשרות למפעיל לשלוח מידע על מבצעים לשדרוג ל-GTAF, כדי שהמידע יישלח למכשירי המשתמשים. השיחות החדשות האלה מאפשרות למפעיל לשלוח הצעות ל-Google.
2. הוספנו שדה של זמן העדכון האחרון ל-PlanGroup.
3. הסרת השדה 'אחוז ניצול הנתונים' מחלון הזמן הגמיש.