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 UTC 的「Zulu」格式時間戳記，單位為奈秒解析度，最多可達九位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
lastUpdatedTime

string (Timestamp format)

數據方案代理程式 (DPA) 從後端系統擷取數據方案狀態的時間。系統會使用這些資料判斷最近的方案狀態資訊。

RFC3339 UTC 的「Zulu」格式時間戳記，單位為奈秒解析度，最多可達九位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。