บันทึกการเปลี่ยนแปลง

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 รายการกับ UI ของแพ็กเกจอินเทอร์เน็ตมือถือ

พฤษภาคม 2019

  1. ต้องระบุ ExpirationTime เว้นแต่แผนจะไม่มีวันหมดอายุ
  2. ตาม RFC 6749 ให้ทำเครื่องหมาย token_type เป็นต้องระบุในการตอบกลับของเซิร์ฟเวอร์ OAuth
  3. ส่งคืนประเภทการแจ้งเตือนที่ส่งไปยังผู้ใช้เมื่อผู้ให้บริการ ส่งสถานะแพ็กเกจไปยัง GTAF

เมษายน 2019

  1. ต้องระบุ AccountInfo สำหรับสมาชิกแบบชำระล่วงหน้า
  2. อัปเดตวิธีการสร้าง CPID ที่แนะนำให้รวมภาษาในข้อความธรรมดาเมื่อสร้าง CPID
  3. นำการรองรับ moreInfoUrl, operatorLogoUrl, purchaseUrl ออกจากข้อเสนอ UI ของแพ็กเกจอินเทอร์เน็ตมือถือไม่รองรับฟิลด์เหล่านี้ การเปลี่ยนแปลงนี้เข้ากันได้แบบย้อนหลัง
  4. เพิ่มการรองรับการส่งการแจ้งเตือนเมื่อผู้ใช้ใช้ยอดคงเหลือในบัญชี โดยใช้ข้อมูลในสถานะแบบจ่ายตามการใช้งาน
  5. นำการรองรับช่วงเวลาที่ยืดหยุ่นออกจากโมดูลแผน การเปลี่ยนแปลงนี้เข้ากันได้แบบย้อนหลัง ดังนั้น หากผู้ให้บริการส่งช่วงเวลาที่ยืดหยุ่นให้เรา ระบบจะยอมรับคำตอบ

มีนาคม 2019

  1. นำ offerInfo.promoMessage ออกจากชุดฟิลด์ที่ต้องระบุ MDP ไม่ได้ ใช้ช่องนี้เมื่อแสดงข้อเสนอต่อผู้ใช้
  2. แก้ไขข้อบกพร่องในเอกสารที่ระบุว่าต้องเข้ารหัส URL ของ CPID แต่ GTAF จะเข้ารหัส CPID ตาม RFC2396
  3. เพิ่มข้อกำหนดสำหรับข้อความ Push

กุมภาพันธ์ 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. เพิ่มฟิลด์สถานะโมดูลแพ็กเกจลงใน PlanModule เพื่อให้ผู้ให้บริการ ระบุแพ็กเกจที่ผู้ใช้ซื้อแล้วแต่ยังไม่ได้เปิดใช้งาน โดยจะใส่ข้อมูลในช่องนี้หรือไม่ก็ได้
  5. เปลี่ยนชื่อ DataPlan เป็น Plan การเปลี่ยนแปลงนี้เป็นเพียงการเปลี่ยนแปลงในเอกสารประกอบเท่านั้น และไม่ควรส่งผลกระทบต่อผู้ให้บริการ
  6. เพิ่มฟิลด์ formOfPayment ลงใน PlanOffer เพื่อให้ผู้ให้บริการระบุวิธีเรียกเก็บเงินจากผู้ใช้สำหรับการ ซื้อได้ โดยค่าเริ่มต้น ระบบจะหักเงินจากยอดคงเหลือในแพ็กเกจ

พฤษภาคม 2018

  1. อัปเดตการตอบกลับ CPID เพื่อให้การตอบกลับยังคงใช้งานย้อนหลังได้
  2. เพิ่มชื่อสำหรับ PlanStatus ระบบจะใช้ชื่อเพื่อป้อนข้อมูลส่วนหัวใน UI ของการตั้งค่า
  3. เพิ่มชื่อโมดูลและไบต์ที่ใช้สำหรับ PlanModule
  4. เพิ่มการเรียกกลับการตอบกลับการซื้อไปยัง GTAF

มีนาคม 2018

การอัปเดตนี้รวมถึงการเปลี่ยนแปลงต่อไปนี้ใน Data Plan Agent API การเปลี่ยนแปลงเหล่านี้ เกี่ยวข้องกับ Data Plan API v4.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. นำฟิลด์เปอร์เซ็นต์เครดิตข้อมูลออกจากช่วงเวลาที่ยืดหยุ่น