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 về điều kiện để 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}

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

Các trường hợp lỗi liệt kê những phản hồi dự kiến từ DPA trong trường hợp xảy ra lỗi. Ngoài ra, DPA PHẢI trả về lỗi trong các trường hợp lỗi sau:

  • DPA trả về mã lỗi 400 YÊU CẦU KHÔNG HỢP LỆ, cho biết với GTAF rằng planId không hợp lệ.
  • DPA trả về mã lỗi 409 CONFLICT (XUNG ĐỘT) 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 PHẢI trả về phản hồi 200-OK. Định dạng của một EligibilityResponse 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 có một planId, phản hồi sẽ chỉ bao gồm kế hoạch đó. Nếu không, danh sách này 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ì DPA PHẢI trả về lỗi 400 YÊU CẦU KHÔNG HỢP LỆ.

Trải nghiệm 5G trên Android

GTAF cho phép hãng vận chuyển chia sẻ trạng thái tính phí theo mức sử dụng cho mỗi loại kết nối đối với người đăng ký. GTAF có thể định kỳ lấy thông tin hoặc các hãng vận chuyển có thể đẩy thông tin dựa trên các điều kiện kích hoạt nội bộ.

Pull API

Thiết bị có thể kéo thông tin về mức sử dụng dữ liệu có tính phí thông qua GTAF bằng cách sử dụng những thông tin sau:

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

Xin lưu ý rằng DPA (Data Plan Agent) đại diện cho một API GW hoặc máy chủ Quyền trong mạng của nhà mạng.

userKey là mã thông báo 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 Meteredness được cung cấp dưới dạng ENUM

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

Trong mô hình kéo, GTAF đóng vai trò là 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 quy trình OAuth được xác định tại đây.

API Đẩy

Nhà mạng cũng có thể gửi thông tin về trạng thái sử dụng theo hạn mức bằng cách sử dụng thông tin sau đây dựa trên một sự kiện 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 sẽ bao gồm planInfoPerClient trong nội dung của thông báo. Các phản hồi lỗi từ GTAF được xác định tại đây

Ở chế độ truyền dữ liệu, GTAF xác thực các yêu cầu đến từ DPA bằng cách sử dụng máy chủ Google Cloud OAuth2. Các yêu cầu đến phải được xác thực dưới dạng một 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.