יומן שינויים

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

יוני 2019

  1. מפרט ה-DPA API מעודכן זה דורש מספקים לאשר את הפרמטר _clientid כפרמטר של שאילתה.
  2. עדכון Mobile Data Plan Sharing API שמאפשר לספקים לשתף עם Google מידע על תוכנית של משתמש עבור לקוח מסוים.
  3. הסדר שבו המבצעים מוצגים למשתמש עשוי להיות שונה מהסדר שבו המבצעים מוצגים ל-GTAF.
  4. GTAF עשוי לשתף יותר מ-10 תוכניות עם ממשק המשתמש של חבילת הגלישה.

מאי 2019

  1. יש צורך ב-ExpirationTime, אלא אם תוקף התוכנית יפוג.
  2. בהתאם לתקן RFC 6749, יש לסמן את Token_type בהתאם לצורך בתגובת שרת OAuth.
  3. מחזירים את סוג ההתראות שנשלחו למשתמש כשהספק נותן את הסטטוס של התוכנית ל-GTAF.

אפריל 2019

  1. מנויים שמשלמים מראש נדרשים לספק פרטי חשבון.
  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. שינית את השם של המדריך לשילוב API לנייד ב-Mobile Data Plan וארגנת אותו מחדש.

נובמבר 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. השם של תוכנית הנתונים השתנה לתוכנית. זהו שינוי תיעוד שלא אמור להשפיע על מפעילים.
  6. השדה formOfPayment נוסף ל-PlanOffer. פעולה זו מאפשרת למפעיל לציין איך המשתמשים יחויבו על הרכישה. ברירת המחדל היא ניכוי מהיתרה בתוכנית.

מאי 2018

  1. עדכון תגובת CPID כדי שהתגובה תהיה תואמת לאחור.
  2. נוספה כותרת לקטע PlanStatus. הכותרת תשמש לאכלוס הכותרת בממשק המשתמש של ההגדרות.
  3. נוסף שם מודול ובייטים בשימוש עבור PlanModule.
  4. נוספה שיחה של תגובת רכישה ל-GTAF.

מרץ 2018

העדכון הזה כולל את השינויים הבאים ב-Data Plan Agent API. השינויים האלה הם יחסיים לגרסה 4.2 של Data Plan API שמתארחת כאן.

  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.

ממשק API לשיתוף תוכניות נתונים לנייד של Google

מרץ 2018

העדכון הזה כולל את השינויים הבאים ב-Google Mobile Data Plan Sharing API:

  1. חדש: קריאות חדשות ל-API, שמאפשרות למפעיל לדחוף מידע על מבצעים להגדלת המכירה ב-GTAF כדי לדחוף אותו למטה למכשירי משתמשים. הקריאות החדשות האלה מאפשרות למפעיל לדחוף מבצעים ל-Google.
  2. הצגת שדה הזמן המעודכן האחרון ב-PlanGroup.
  3. הסרת השדה של אחוז הקרדיט על הנתונים מחלון הזמן הגמיש.