變更記錄

Data Plan Agent API

2019 年 12 月

  1. 已為註冊 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 產生規定。
  4. 新增說明文件，以便在呼叫 Mobile Data Plan Shared API 時回報 GTAF 的不同錯誤回應。

2019 年 6 月

  1. 更新 DPA API 規格，要求電信業者接受 _clientid 做為查詢參數。
  2. 更新 Mobile Data Plan Shared API，方便電信業者將特定用戶端的使用者方案資訊提供給 Google。
  3. 向使用者顯示的優惠順序可能與提供 GTAF 優惠的順序不同。
  4. GTAF 可能與行動數據方案使用者介面分享超過 10 項方案，

2019 年 5 月

  1. 除非方案並未到期，否則 ExpirationTime 為必填欄位。
  2. 根據 RFC 6749 的規定，在 OAuth 伺服器回應中將權杖權杖標示為必填。
  3. 傳回當電信業者將方案狀態推送至 GTAF 時，已傳送給使用者的通知類型。

2019 年 4 月

  1. 必須為預付訂閱者提供 AccountInfo。
  2. 更新建議的 CPID 產生方法，以便在產生 CPID 時以純文字格式納入語言。
  3. 移除優惠中的 moreInfoUrl、OperatorLogoUrl 和 PurchaseUrl 支援。行動數據方案使用者介面不支援這些欄位。變更具回溯相容性。
  4. 新增支援功能，當使用者以即付即用的狀態將資料支出帳戶餘額時，系統就會傳送通知。
  5. 從計畫模組中移除彈性時間範圍的支援。變更具回溯相容性。因此，如果運算子將彈性時間範圍傳送給我們，系統會接受回應。

2019 年 3 月

  1. 從必填欄位組合中移除 offerInfo.promoMessage。MDP 向使用者顯示優惠時，不會使用這個欄位。
  2. 修正說明文件錯誤，指出 CPID 必須經過網址編碼。相反地，GTAF 會將 CPID 編碼為 RFC2396。
  3. 新增推播通知相關規定。

2019 年 2 月

  1. 已移除透過資料方案共用 API 與 Google 共用 PlanOffer 的支援功能。

2019 年 1 月

  1. 新增透過 ISP 入口網站更新電信業者設定的指南。
  2. 新增 Data Plan Agent API 的 OAuth 實作指南。
  3. 重新命名並重新整理 Mobile Data Plan Shared 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 中新增「plan module module state」(方案模組狀態) 欄位，可讓運算子指出使用者已購買但尚未啟用的方案。此為必填欄位。
  5. DataPlan 已重新命名為「Plan」。這是影響運算子的說明文件變更。
  6. 在 PlanOffer 中加入 formOfPayment 欄位，可讓運算子指定使用者要支付的購買交易費用。這會從方案餘額中扣除。

2018 年 5 月

  1. 已更新 CPID 回應，確保回應具備回溯相容性。
  2. 為 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. 變更我們對數據方案狀態所呼叫的網址。如需新網址的說明，請參閱這篇文章。DPA 預計會傳回 PlanStatus 的例項。
  3. 變更我們提議的方案網址。如需新網址的說明，請參閱這篇文章。DPA 預計會傳回 PlanOffer 的執行個體。
  4. 變更購買方案時，傳送至 DPA 的要求內文。請注意，API 呼叫相同。要求主體現在包含 TransactionRequest 執行個體。請注意，與舊版 API 相比，巢狀結構的移除情形。
  5. 購物要求的回應已變更。我們使用 Google protobuf 定義的貨幣類型，為了回應成功的購買行為，我們預期回應主體會包含 TransactionResponse 的例項。
  6. 如果未指定 plan_id，則資格 API 「必須」傳回使用者有資格使用的所有資料方案。先前為選用項目。
  7. 為 GTAF 新增 MSISDN 註冊端點，以便註冊 MSISDN 以接收 DPA 通知。

Google Mobile Data Plan Shared API

2018 年 3 月

本次更新內含 Google Mobile Data Plan Shared API 的下列異動：

  1. 推出新的 API 呼叫，讓操作人員將向上銷售資訊推送到 GTAF 中，以便進一步推送給使用者。這些新的呼叫可讓運算子將優惠推送至 Google。
  2. 在 PlanGroup 中加入上次更新的時間欄位。
  3. 從彈性時間範圍內移除資料抵免額百分比欄位。