กรณีการใช้งานเพิ่มเติม

การมีสิทธิ์

GTAF อาจส่งคำขอตรวจสอบสิทธิ์ต่อไปนี้เพื่อดูว่าผู้ใช้มีสิทธิ์ซื้อแพ็กเกจหรือไม่

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

โปรดทราบว่า planId คือตัวระบุที่ไม่ซ้ำกันสำหรับแพ็กเกจที่ใช้ซื้อแพ็กเกจในนามของผู้ใช้ได้ (ดูการซื้อข้อมูล) หากไม่ได้ระบุ planId DPA จะต้องแสดงแพ็กเกจทั้งหมดที่ผู้ใช้ซื้อได้

กรณีข้อผิดพลาดแสดงการตอบกลับที่คาดไว้จาก DPA ในกรณี ที่เกิดข้อผิดพลาด นอกจากนี้ DPA จะต้องแสดงข้อผิดพลาดในกรณีต่อไปนี้

• DPA จะแสดงรหัสข้อผิดพลาด 400 BAD REQUEST ซึ่งบ่งชี้ให้ GTAF ทราบว่า planId ไม่ถูกต้อง
• DPA จะแสดงรหัสข้อผิดพลาด 409 CONFLICT ซึ่งบ่งชี้ว่า planId ไม่ เข้ากันกับแพ็กเกจอินเทอร์เน็ตของผู้ใช้

ไม่เช่นนั้น DPA จะต้องส่งการตอบกลับ 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 (Data Plan Agent) แสดงถึง API GW หรือเซิร์ฟเวอร์การให้สิทธิ์ในเครือข่ายของผู้ให้บริการ

userKey คือโทเค็นการตรวจสอบสิทธิ์ที่สร้างขึ้นในระหว่างระยะการตรวจสอบสิทธิ์เริ่มต้น ตามที่กำหนดไว้ที่นี่

client_id คือ AndroidSystemInfo

สถานะการวัดการใช้งานจะแสดงเป็น 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 คำขอขาเข้าต้องได้รับการตรวจสอบสิทธิ์เป็นบัญชีบริการที่ได้รับการเพิ่มลงในรายการที่อนุญาตใน ISP Portal สำหรับ ASN ที่ DPA เป็นตัวแทน นอกจากนี้ โปรดดูรายละเอียดเพิ่มเติมในคู่มือการผสานรวมที่นี่