Changelog

Data Plan Agent API

2019 年 12 月

  1. 導入 register CPID API，供 DPA 實作。
  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. 說明可能的用戶端 ID 值。
  2. 新增帳戶加值通知支援。
  3. 放寬 CPID 生成規定，不必每次呼叫 CPID 端點時都生成新的 CPID。
  4. 新增說明文件，說明呼叫 Mobile Data Plan Sharing API 時，GTAF 傳回的不同錯誤回應。

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 的支援。 行動數據方案 UI 不支援這些欄位。這項變更可回溯相容。
  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. 在優惠中新增連線類型。
  4. 在 PlanModule 中新增方案模組狀態欄位，方便電信業者指出使用者已購買但尚未啟用的方案。這不是必填欄位。
  5. 「DataPlan」已重新命名為「Plan」。這項異動只會影響說明文件，不會影響運算子。
  6. 在 PlanOffer 中新增 formOfPayment 欄位，讓營運商指定向使用者收取費用的方式。系統預設會從方案餘額扣除。

2018 年 5 月

  1. 更新 CPID 回應，確保回溯相容性。
  2. 已為「PlanStatus」PlanStatus新增標題。這個標題會用於填入設定 UI 中的標題。
  3. 新增模組名稱，並為 PlanModule 使用位元組。
  4. 在 GTAF 中新增購買交易回應回呼。

2018 年 3 月

本次更新對 Data Plan Agent API 進行了下列變更。這些變更與這裡代管的 Data Plan API v4.2 相關。

  1. 下列 API 呼叫已淘汰：
    1. 查詢使用者帳戶 (DPA_URL/{data_plan_key_string}/account)。
    2. 查詢已購買的方案 (DPA_URL/{data_plan_key_string}/purchasedPlans)。
  2. 變更我們呼叫的網址，以取得資料方案狀態。新網址的說明請參閱這篇文章。資料保護管理員應會傳回 PlanStatus 的執行個體。
  3. 變更我們呼叫的方案優惠網址。新網址的說明請參閱這篇文章。DPA 預計會傳回 PlanOffer 的執行個體。
  4. 購買方案時，變更傳送至 DPA 的要求主體。請注意，API 呼叫是相同的。要求主體現在包含 TransactionRequest 的例項。請注意，相較於舊版 API，這個版本已移除一個巢狀層級。
  5. 購買要求的回覆已變更。我們採用 Google protobuf 定義的貨幣類型。如果購買交易成功，我們預期回應主體會包含 TransactionResponse 的例項。
  6. 如果未指定 plan_id，資格 API 必須傳回使用者符合資格的所有資料方案。先前這項設定為選用。
  7. 新增 GTAF 的 MSISDN 註冊端點，以便向 DPA 註冊 MSISDN 以接收通知。

Google Mobile Data Plan Sharing API

2018 年 3 月

本次更新對 Google Mobile Data Plan Sharing API 進行以下變更：

  1. 推出新的 API 呼叫，讓電信業者將加購優惠資訊推送至 GTAF，再進一步推送至使用者裝置。這些新呼叫可讓電信業者將優惠推送到 Google。
  2. 在 PlanGroup 中導入上次更新時間欄位。
  3. 從彈性時間範圍中移除資料抵免百分比欄位。