Nhật ký thay đổi

Data Plan Agent API

Tháng 12 năm 2019

  1. Giới thiệu định nghĩa API đăng ký CPID để DPA triển khai.
  2. Thêm đề xuất về cách tạo CPID và lưu trữ CPID khi ứng dụng khách yêu cầu một CPID mới.
  3. Thêm tài liệu về cách chọn CPID sẽ dùng để gửi thông báo.
  4. Làm rõ cách xác định lựa chọn ưu tiên về ngôn ngữ của 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 một 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 (chương trình ưu đãi) cho đến nay được đánh dấu là trường bắt buộc.

Tháng 9 năm 2019

  1. Thêm tính năng hỗ trợ cho thông báo hết hạn dữ liệu, 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ị có thể có của giá trị nhận dạng ứng dụng khách.
  2. Thêm tính năng hỗ trợ cho thông báo nạp tiền vào tài khoản.
  3. Nới lỏng các yêu cầu về việc tạo CPID từ việc yêu cầu một CPID mới mỗi khi điểm cuối CPID được gọi.
  4. Thêm tài liệu cho 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 quy cách API DPA yêu cầu hãng vận chuyển chấp nhận _clientid làm tham số truy vấn.
  2. Cập nhật Mobile Data Plan Sharing API (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 ứng dụng cụ thể với Google.
  3. Thứ tự mà người dùng nhìn thấy các mặt hàng có thể không giống với thứ tự mà các mặt hàng được cung cấp 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ạn phải cung cấp ExpirationTime, trừ phi gói không hết hạn.
  2. Theo RFC 6749, hãy đánh dấu token_type là bắt buộc 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 hãng vận chuyển gửi trạng thái kế hoạch đến GTAF.

Tháng 4 năm 2019

  1. AccountInfo là thông tin bắt buộc đối với người đăng ký trả trước.
  2. Cập nhật phương thức tạo CPID được đề xuất để thêm ngôn ngữ vào văn bản thuần tuý 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 có khả năng tương thích ngược.
  4. Đã thêm tính năng hỗ trợ gửi thông báo khi người dùng đang chi tiêu số dư tài khoản bằng dữ liệu ở trạng thái trả tiền khi dùng.
  5. Xoá tính năng hỗ trợ khung giờ linh hoạt khỏi các mô-đun kế hoạch. Thay đổi này có khả năng tương thích ngược. Vì vậy, nếu một đơn vị vận hành gửi cho chúng tôi các khung giờ linh hoạt, thì yêu cầu sẽ được chấp nhận.

Tháng 3 năm 2019

  1. Xoá 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 trong tài liệu cho biết rằng CPID phải được mã hoá URL. Thay vào đó, GTAF mã hoá CPID theo RFC2396.
  3. Đã thêm các yêu cầu đối với thông báo đẩy.

Tháng 2 năm 2019

  1. Xoá tính nă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 cập nhật cấu hình nhà mạng bằng cổng thông tin ISP.
  2. Thêm hướng dẫn về việc triển khai OAuth cho Data Plan Agent API.
  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 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 kế hoạch 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 nhà khai thác.
  2. Thêm tính năng hỗ trợ cho các gói làm mới hạn mức theo định kỳ vào PlanModule và Offer.
  3. Thêm tính năng hỗ trợ cho thông báo hết hạn.
  4. Đổi tên PlanModuleState thành PlanState. Đây là một thay đổi về tài liệu và sẽ không ảnh hưởng đến các toán tử.

Tháng 8 năm 2018

  1. Thêm chức năng cho phép hãng vận chuyển chỉ định số dư tài khoản trong PlanStatus.

Tháng 6 năm 2018

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

Tháng 5 năm 2018

  1. Đã cập nhật phản hồi CPID để duy trì khả năng tương thích ngược của phản hồi.
  2. Đã thêm tiêu đề cho PlanStatus. Tiêu đề này sẽ được dùng để điền thông tin vào tiêu đề trong giao diện người dùng cài đặt.
  3. Đã thêm tên mô-đun và số byte đã dùng cho PlanModule.
  4. Đã thêm lệnh gọi lạ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 những thay đổi sau đối với Data Plan Agent API. Những thay đổi này liên quan đến Data Plan API phiên bản 4.2 được lưu trữ tại đây.

  1. Không dùng các lệnh gọi API sau nữa:
    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}/purchasedPlans).
  2. Thay đổi URL mà chúng tôi gọi để biết 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 phiên bản của PlanStatus.
  3. Thay đổi URL mà chúng tôi gọi cho các ưu đãi trong gói. URL mới được mô tả tại đây. DPA dự kiến sẽ trả về một phiên bản của PlanOffer.
  4. Thay đổi nội dung yêu cầu được gửi đến DPA khi mua gói. Xin lưu ý rằng lệnh gọi API là như nhau. Nội dung yêu cầu hiện chứa một phiên bản của TransactionRequest. Lưu ý rằng một cấp độ lồng ghép đã bị xoá so với phiên bản API trước.
  5. Phản hồi đối với yêu cầu mua đã 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 một 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ả gói dữ liệu mà người dùng đủ điều kiện sử dụng. Trước đây, việc này là không bắt buộc.
  7. Thêm một điểm cuối đăng ký MSISDN cho GTAF để đăng ký MSISDN cho thông báo bằng DPA.

Google Mobile Data Plan Sharing API

Tháng 3 năm 2018

Bản cập nhật này bao gồm những 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 nhà điều hành đẩy thông tin về ưu đãi bán thêm lên GTAF để đẩ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 nhà mạng gửi các ư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. Xoá trường tỷ lệ phần trăm tín dụng dữ liệu khỏi khung giờ linh hoạt.