更新日志

数据方案代理 API

2019 年 12 月

  1. 为 DPA 引入了 register CPID API 定义以供实现。
  2. 添加了有关在客户端请求新 CPID 时如何生成并存储该 CPID 的建议。
  3. 添加了有关如何选择用于发送通知的 CPID 的文档。
  4. 明确了 GTAF 调用 DPA 时以及 DPA 调用 GTAF 时如何确定用户语言偏好设置。

2019 年 10 月

  1. 每次与 CPID 端点联系时，都需要新的 CPID。为此，您可以向 CPID 生成算法添加时间戳。
  2. 从 Offer 中移除了 planLanguage，该字段之前被标记为必填字段。

2019 年 9 月

  1. 添加了对数据过期通知的支持，与数据过期警告通知区分开来。

2019 年 7 月

  1. 阐明了可能的客户端标识符值。
  2. 添加了对账号充值通知的支持。
  3. 放宽了 CPID 生成要求，不再要求每次调用 CPID 端点时都生成新的 CPID。
  4. 添加了有关从 GTAF 调用 Mobile Data Plan Sharing API 时返回的不同错误响应的文档。

2019 年 6 月

  1. 更新了 DPA API 规范，要求运营商接受 _clientid 作为查询参数。
  2. 更新了移动流量套餐共享 API，允许运营商与 Google 共享特定客户的流量套餐信息。
  3. 向用户显示优惠的顺序可能与向 GTAF 提供优惠的顺序不同。
  4. GTAF 可能会与“移动数据流量套餐”界面共享 10 个以上的方案。

2019 年 5 月

  1. 除非相应方案不会过期，否则必须提供 ExpirationTime。
  2. 根据 RFC 6749，在 OAuth 服务器响应中将 token_type 标记为必需。
  3. 当运营商向 GTAF 推送方案状态时，返回已发送给用户的通知类型。

2019 年 4 月

  1. 预付费订阅者需要提供 AccountInfo。
  2. 更新了推荐的 CPID 生成方法，以在生成 CPID 时在纯文本中包含语言。
  3. 移除了对优惠中的 moreInfoUrl、operatorLogoUrl、purchaseUrl 的支持。 这些字段不受移动数据流量方案界面支持。此更改向后兼容。
  4. 添加了对以下情况的支持：当用户在按流量付费状态下使用数据时，发送通知。
  5. 从计划模块中移除了对灵活时间窗口的支持。此更改向后兼容。因此，如果运营商向我们发送灵活时间窗口，系统会接受相应响应。

2019 年 3 月

  1. 从必填字段集中移除了 offerInfo.promoMessage。MDP 在向用户显示优惠时不会使用此字段。
  2. 修复了文档错误，该错误指出 CPID 必须经过网址编码。相反，GTAF 会根据 RFC2396 对 CPID 进行编码。
  3. 添加了有关推送通知的要求。

2019 年 2 月

  1. 移除了使用流量套餐共享 API 与 Google 共享 PlanOffer 的支持。

2019 年 1 月

  1. 添加了有关使用 ISP 门户更新运营商配置的指南。
  2. 添加了有关为 Data Plan Agent API 实现 OAuth 的指南。
  3. 重命名并重新整理了 Mobile Data Plan Sharing API 集成指南。

2018 年 11 月

  1. 添加了对方案激活通知的支持。
  2. 添加了对 APP_STORE 方案模块流量类别的支持。

2018 年 9 月

  1. 添加了 API 以向运营商报告用户意见征求情况。
  2. 为定期刷新配额的方案添加了对 PlanModule 和 Offer 的支持。
  3. 新增了对过期通知的支持。
  4. 将 PlanModuleState 重命名为 PlanState。 这是一项文档变更，不应影响运营商。

2018 年 8 月

  1. 添加了运营商在 PlanStatus 中指定账号余额的功能。

2018 年 6 月

  1. 移除了用于更新和获取方案状态和方案优惠的方法。
  2. 允许在填充字节余额或时间余额的同时填充粗略余额级别。
  3. 为 Offer 添加了连接类型。
  4. 向 PlanModule 添加了方案模块状态字段，以便运营商指示用户已购买但尚未激活的方案。 此字段不是必填字段。
  5. DataPlan 已重命名为 Plan。这是一项文档变更，不应影响运营商。
  6. 向 PlanOffer 添加了 formOfPayment 字段，允许运营商指定向用户收取购买费用的方式。默认情况下，系统会从方案余额中扣除。

2018 年 5 月

  1. 更新了 CPID 响应，以保持响应向后兼容。
  2. 为 PlanStatus 添加了标题。该标题将用于填充设置界面中的标题。
  3. 为 PlanModule 添加了模块名称和使用的字节。
  4. 向 GTAF 添加了购买交易响应回调。

2018 年 3 月

此更新对数据流量方案代理 API 进行了以下更改。这些更改是相对于此处托管的 Data Plan API v4.2 而言的。

  1. 弃用了以下 API 调用：
    1. 正在查询用户账号 (DPA_网址/{data_plan_key_string}/account)。
    2. 查询已购买的方案 (DPA_网址/{data_plan_key_string}/purchasedPlans)。
  2. 更改了我们用于获取流量套餐状态的网址。有关新网址的说明，请参见此处。DPA 应返回 PlanStatus 的实例。
  3. 更改了我们针对方案优惠调用的网址。有关新网址的说明，请参见此处。DPA 应返回 PlanOffer 的实例。
  4. 更改购买方案时发送给 DPA 的请求正文。请注意，API 调用是相同的。请求正文现在包含一个 TransactionRequest 实例。请注意，与之前的 API 版本相比，嵌套级别减少了一级。
  5. 对购买请求的响应已发生变化。我们利用了 Google protobuf 定义的币种类型。如果购买成功，我们希望响应正文包含一个 TransactionResponse 实例。
  6. 如果未指定 plan_id，则资格条件 API 必须返回用户有资格使用的所有流量方案。之前，此属性是可选属性。
  7. 添加了 MSISDN 注册端点，以便 GTAF 向 DPA 注册 MSISDN 以接收通知。

Google Mobile Data Plan Sharing API

2018 年 3 月

此更新对 Google 移动流量套餐共享 API 进行了以下更改：

  1. 引入了新的 API 调用，允许运营商将追加销售优惠信息推送到 GTAF，以便进一步推送到用户设备。借助这些新调用，运营商可以向 Google 推送优惠。
  2. 在 PlanGroup 中引入了上次更新时间字段。
  3. 从弹性时间窗口中移除了数据流量抵扣百分比字段。