Các trường hợp sử dụng khác

Điều kiện sử dụng

GTAF CÓ thể đưa ra yêu cầu sau đây để kiểm tra xem người dùng có đủ điều kiện mua gói hay không.

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

Lưu ý rằng planId là giá trị nhận dạng duy nhất cho gói có thể dùng để mua gói thay mặt cho người dùng (Xem Mua dữ liệu). Nếu planId không được chỉ định, DPA PHẢI trả về tất cả các kế hoạch của người dùng.

Trường hợp lỗi liệt kê các phản hồi dự kiến từ DPA trong trường hợp xảy ra lỗi. Ngoài ra, DPA SHALL sẽ trả về lỗi trong các trường hợp lỗi sau:

• DPA trả về mã lỗi 400 BAD REQUEST cho GTAF biết rằng planId không hợp lệ.
• DPA trả về mã lỗi CONFLICT 409 cho biết planId không tương thích với gói dữ liệu của người dùng.

Nếu không, DPA SHALL sẽ trả về phản hồi 200 OK. Định dạng của một EligibleResponse thành công là:

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

Khi yêu cầu bao gồm một planId, phản hồi chỉ bao gồm gói đó. Nếu không, danh sách sẽ bao gồm tất cả các gói mà người dùng đủ điều kiện để mua. Trong trường hợp planId trống và DPA không hỗ trợ trả về danh sách các gói đủ điều kiện, thì PHẢI PHẢI trả về lỗi 400 BAD REQUEST.

Trải nghiệm Android 5G

GTAF cho phép nhà mạng chia sẻ trạng thái đo lượng dữ liệu trên mỗi loại kết nối cho người đăng ký. GTAF có thể lấy thông tin này theo định kỳ hoặc các nhà mạng có thể đẩy thông tin dựa trên trình kích hoạt nội bộ.

API Lấy dữ liệu

Thiết bị có thể lấy thông tin đo lượng dữ liệu thông qua GTAF bằng những cách sau:

GET DPA/{userKey}/planStatus?key_type={userKey}&client_id=AndroidSystemInfo

Xin lưu ý rằng DPA (Tác nhân gói dữ liệu) đại diện cho một máy chủ API GW hoặc Quyền trong mạng của nhà mạng.

userKey là mã xác thực được thiết lập trong giai đoạn xác thực ban đầu như được xác định tại đây.

client_id là AndroidSystemInfo

Trạng thái Đo lường được cung cấp dưới dạng ENUM

DPA sẽ trả về 200 phản hồi OK và bao gồm planInfoPerClient Việc xác định lỗi cho DPA được xác định tại đây

Trong mô hình lấy, GTAF hoạt động như một ứng dụng và xác thực chứng chỉ SSL của DPA. GTAF tự xác thực với DPA bằng cách sử dụng quy trình OAuth được xác định tại đây.

API Đẩy

Nhà mạng cũng có thể đẩy thông tin đo lượng dữ liệu bằng cách sử dụng thông tin sau dựa trên một sự kiện của trình kích hoạt, ví dụ: thay đổi gói giá, v.v.

POST https://mobiledataplansharing.googleapis.com/v1/operators/12345/clients/AndroidSystemInfo/users/abcdef/planStatus

DPA phải bao gồm planInfoPerClient trong phần nội dung của thông báo. Phản hồi lỗi từ GTAF được xác định tại đây

Ở chế độ đẩy, GTAF xác thực các yêu cầu đến từ DPA bằng máy chủ OAuth2 của Google Cloud. Các yêu cầu được gửi đến phải được xác thực là tài khoản dịch vụ đã được đưa vào danh sách cho phép trong Cổng thông tin ISP cho ASN mà DPA đại diện. Ngoài ra, hãy tham khảo hướng dẫn tích hợp tại đây để biết thêm thông tin chi tiết.