Method: operators.planGroups.create

允許行動網路業者 (以專屬自治系統編號 (ASN) 識別) 新增 PlanGroup 項目。

HTTP 要求

POST https://mobiledataplansharing.googleapis.com/v1/{parent=operators/*}/planGroups

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

父項資源的資源名稱，格式如下：operators/{asn_id}。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "planGroupId": string,
  "planGroup": {
    object (PlanGroup)
  }
}
欄位
planGroupId

string

planGroupId，可向行動網路業者唯一識別訂閱者。舉例來說，planGroupId 可以是行動台國際用戶目錄號碼 (MSISDN) 或 MSISDN 的加密版本。
planGroup

object (PlanGroup)

要建立的 PlanGroup 資源。

回應主體

如果成功，回應主體會含有以下結構的資料：

PlanGroup 包含使用者購買的所有頂層行動服務套裝組合詳細資料。

JSON 表示法 
{
  "name": string,
  "dataPlans": [
    {
      object (Plan)
    }
  ],
  "responseStaleTime": string,
  "lastUpdatedTime": string
}
欄位
name

string

方案群組的資源名稱，格式如下：operators/{asn_id}/planGroups/{planGroupId}。建立 PlanGroup 項目時，系統會忽略名稱。
dataPlans[]

object (Plan)

這位使用者擁有的資料方案清單。
responseStaleTime

string (Timestamp format)

共用方案群組資訊過時的時間。之後應用程式將不會收到 PlanGroup。

RFC3339 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。例如："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
lastUpdatedTime

string (Timestamp format)

資料方案代理程式 (DPA) 從後端系統擷取資料方案狀態資訊的時間。用於判斷資料方案狀態資訊的最新程度。

RFC3339 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。例如："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/dataplansharing

詳情請參閱 OAuth 2.0 總覽。