Nhật ký thay đổi

API tác nhân gói dữ liệu

Tháng 12 năm 2019

  1. Giới thiệu định nghĩa API đăng ký CPID cho DPA để triển khai.
  2. Thêm đề xuất về cách tạo CPID và lưu trữ nó khi khách hàng yêu cầu một CPID mới.
  3. Thêm tài liệu về cách chọn CPID dùng để gửi thông báo.
  4. Làm rõ cách xác định các tuỳ chọn ngôn ngữ người dùng khi GTAF gọi DPA và khi DPA gọi GTAF.

Tháng 10 năm 2019

  1. Yêu cầu phải có CPID mới mỗi khi chúng tôi liên hệ với điểm cuối CPID. Bạn có thể thực hiện việc này bằng cách thêm dấu thời gian vào thuật toán tạo CPID.
  2. Xoá planLanguage khỏi Offer mà cho đến nay được đánh dấu là trường bắt buộc.

Tháng 9 năm 2019

  1. Bổ sung hỗ trợ cho các thông báo hết hạn dữ liệu, được phân biệt với thông báo cảnh báo hết hạn dữ liệu.

Tháng 7 năm 2019

  1. Làm rõ các giá trị mã nhận dạng khách hàng.
  2. Thêm tùy chọn hỗ trợ cho thông báo nạp tiền tài khoản.
  3. Nới lỏng các yêu cầu về tạo CPID để yêu cầu chỉ định CPID mới mỗi khi gọi điểm cuối CPU.
  4. Thêm tài liệu về các phản hồi lỗi khác nhau từ GTAF khi gọi API Chia sẻ gói dữ liệu di động.

Tháng 6 năm 2019

  1. Cập nhật thông số kỹ thuật của API DPA yêu cầu nhà mạng phải chấp nhận _clientid làm thông số truy vấn.
  2. Đã cập nhật API Chia sẻ gói dữ liệu di động cho phép nhà mạng chia sẻ thông tin gói của người dùng cho một khách hàng cụ thể với Google.
  3. Thứ tự hiển thị các ưu đãi cho người dùng có thể không giống với thứ tự của các ưu đãi được gửi cho GTAF.
  4. GTAF có thể chia sẻ hơn 10 gói với giao diện người dùng Gói dữ liệu di động.

Tháng 5 năm 2019

  1. Bắt buộc hết hạn trừ phi gói này không hết hạn.
  2. Theo RFC 6749, hãy đánh dấu token_type theo yêu cầu trong phản hồi của máy chủ OAuth.
  3. Trả về loại thông báo đã được gửi cho người dùng khi nhà mạng đẩy trạng thái gói đến GTAF.

Tháng 4 năm 2019

  1. Người đăng ký trả trước bắt buộc phải có AccountInfo.
  2. Cập nhật phương thức tạo CPID được đề xuất để đưa nội dung vào văn bản thuần túy khi tạo CPID.
  3. Xoá tính năng hỗ trợ cho moreInfoUrl, operatorLogoUrl, purchaseUrl khỏi các ưu đãi. Giao diện người dùng của gói dữ liệu di động không hỗ trợ các trường này. Thay đổi này tương thích ngược.
  4. Hỗ trợ thêm tính năng gửi thông báo khi người dùng chi tiêu số dư tài khoản bằng cách sử dụng dữ liệu thanh toán theo trạng thái.
  5. Xoá tính năng hỗ trợ thời lượng linh hoạt khỏi các mô-đun gói. Thay đổi này tương thích ngược. Vì vậy, nếu một toán tử đang gửi cho chúng tôi khoảng thời gian linh hoạt, phản hồi sẽ được chấp nhận.

Tháng 3 năm 2019

  1. Xóa offerInfo.promoMessage khỏi nhóm trường bắt buộc. MDP không sử dụng trường này khi hiển thị ưu đãi cho người dùng.
  2. Sửa lỗi tài liệu nói rằng CPID phải được mã hoá URL. Thay vào đó, GTAF mã hoá CPID theo RFC2396.
  3. Thêm yêu cầu đối với thông báo đẩy.

Tháng 2 năm 2019

  1. Đã ngừng hỗ trợ chia sẻ PlanOffer với Google bằng API chia sẻ gói dữ liệu.

Tháng 1 năm 2019

  1. Thêm hướng dẫn về cách cập nhật cấu hình của nhà mạng bằng cổng thông tin ISP.
  2. Thêm hướng dẫn về cách triển khai OAuth cho API Tác nhân gói dữ liệu.
  3. Đã đổi tên và sắp xếp lại hướng dẫn tích hợp API Chia sẻ gói dữ liệu di động.

Tháng 11 năm 2018

  1. Thêm tính năng hỗ trợ cho các thông báo kích hoạt gói.
  2. Thêm tính năng hỗ trợ cho danh mục lưu lượng truy cập mô-đun gói APP_STORE.

Tháng 9 năm 2018

  1. Thêm API để báo cáo sự đồng ý của người dùng cho các toán tử.
  2. Thêm tính năng hỗ trợ cho các kế hoạch định kỳ làm mới hạn mức cho PlanModuleOffer.
  3. Hỗ trợ thêm thông báo về ngày hết hạn.
  4. Đổi tên PlanModuleState thành PlanState. Đây là một thay đổi về tài liệu sẽ không ảnh hưởng đến toán tử.

Tháng 8 năm 2018

  1. Thêm khả năng để các nhà mạng chỉ định số dư tài khoản trong một PlanStatus.

Tháng 6 năm 2018

  1. Đã xóa bản cập nhật, hãy tìm các phương thức để biết trạng thái gói và ưu đãi của gói.
  2. Mức cân bằng thô được cho phép được điền cùng lúc khi số dư byte hoặc số dư thời gian được điền.
  3. Thêm loại kết nối vào Ưu đãi.
  4. Thêm trường trạng thái mô-đun kế hoạch vào PlanModule để cho phép toán tử cho biết những gói mà người dùng đã mua nhưng chưa được kích hoạt. Đây không phải là trường bắt buộc.
  5. DataPlan được đổi tên thành Plan (Lập kế hoạch). Đây là một thay đổi về tài liệu sẽ không ảnh hưởng đến toán tử.
  6. Đã thêm trường formOfPayment vào PlanOffer cho phép toán tử chỉ định cách người dùng sẽ bị tính phí cho giao dịch mua. Giá trị này mặc định là khấu trừ từ số dư gói.

Tháng 5 năm 2018

  1. Cập nhật phản hồi CPU để phản hồi tương thích ngược.
  2. Thêm tiêu đề cho PlanStatus. Tiêu đề sẽ được dùng để điền tiêu đề vào giao diện người dùng cài đặt.
  3. Thêm tên mô-đun và các byte đã dùng cho PlanModule.
  4. Đã thêm lại cuộc gọi phản hồi mua hàng vào GTAF.

Tháng 3 năm 2018

Bản cập nhật này bao gồm các thay đổi sau đối với API Tác nhân gói dữ liệu. Những thay đổi này liên quan đến API gói dữ liệu v4.2 được lưu trữ tại đây.

  1. Ngừng sử dụng các lệnh gọi API sau:
    1. Truy vấn tài khoản người dùng (DPA_URL/{data_plan_key_string}/account).
    2. Truy vấn các gói đã mua (DPA_URL/{data_plan_key_string}/buyPlans).
  2. Thay đổi URL mà chúng tôi gọi cho trạng thái gói dữ liệu. URL mới được mô tả tại đây. DPA dự kiến sẽ trả về một bản sao của PlanStatus.
  3. Thay đổi URL mà chúng tôi gọi cho các ưu đãi của gói. URL mới được mô tả tại đây. DPA dự kiến sẽ trả về một thực thể của PlanOffer.
  4. Thay đổi phần nội dung của yêu cầu được gửi đến DPA khi mua một gói. Lưu ý rằng lệnh gọi API giống nhau. Phần nội dung của yêu cầu hiện chứa một thực thể của transactionRequest. Hãy lưu ý việc xoá cấp độ lồng ghép so với phiên bản API trước.
  5. Phản hồi cho yêu cầu mua hàng đã thay đổi. Chúng tôi tận dụng loại đơn vị tiền tệ do Google protobuf xác định. Để phản hồi giao dịch mua thành công, chúng tôi dự kiến nội dung phản hồi sẽ chứa một phiên bản của TransactionResponse.
  6. Nếu không chỉ định plan_id, thì API đủ điều kiện PHẢI trả về tất cả các gói dữ liệu mà người dùng đủ điều kiện. Trước đây, bạn không bắt buộc phải làm việc này.
  7. Thêm điểm cuối đăng ký MSISDN cho GTAF để đăng ký MSISDN cho các thông báo với DPA.

API Chia sẻ gói dữ liệu di động của Google

Tháng 3 năm 2018

Bản cập nhật này bao gồm các thay đổi sau đối với API chia sẻ gói dữ liệu di động của Google:

  1. Giới thiệu các lệnh gọi API mới cho phép toán tử đẩy thông tin ưu đãi bán thêm lên GTAF để tiếp tục đẩy xuống các thiết bị của người dùng. Những lệnh gọi mới này cho phép toán tử đẩy ưu đãi đến Google.
  2. Giới thiệu trường thời gian cập nhật gần đây nhất trong PlanGroup.
  3. Xóa trường tỷ lệ phần trăm tín dụng dữ liệu khỏi khoảng thời gian linh hoạt.