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

เกณฑ์การมีสิทธิ์

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

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

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

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

• DPA แสดงรหัสข้อผิดพลาด 400 ป้ายคําขอ ซึ่งระบุไปยัง GTAF ว่า planId ไม่ถูกต้อง
• DPA แสดงรหัสข้อผิดพลาด 409 CONFLICT ซึ่งบ่งชี้ว่า planId เข้ากันไม่ได้กับแผนข้อมูลของผู้ใช้

ไม่เช่นนั้น DPA SHALL จะแสดงผลการตอบกลับ 200-OK รูปแบบของการมีสิทธิ์ในการตอบกลับที่ประสบความสําเร็จมีดังนี้

{
  "eligiblePlans":
  [
   {
    "planId": string,   // Plan identifier. Can be used to
                        // refer to the plan during
                        // offers, etc. (req.)
   }
  ]
}

เมื่อคําขอมี planId การตอบกลับจะรวมเฉพาะแพ็กเกจนั้น มิเช่นนั้น รายการนี้จะมีแพ็กเกจทั้งหมดที่ผู้ใช้มีสิทธิ์ซื้อ ในกรณีที่ planId ว่างเปล่าและ DPA ไม่สนับสนุนการแสดงรายการแพ็กเกจที่มีสิทธิ์ ต้องแสดงข้อผิดพลาด 400 คําขอคําขอ

ประสบการณ์การใช้ Android 5G

GTAF ช่วยให้ผู้ให้บริการแชร์สถานะการวัดปริมาณอินเทอร์เน็ตต่อประเภทการเชื่อมต่อสําหรับสมาชิกได้ GTAF จะดึงข้อมูลนี้เป็นระยะๆ หรือผู้ให้บริการสามารถพุชข้อมูลตามทริกเกอร์ภายในได้

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