Method: operators.planGroups.create

モバイル オペレーター(固有の自律システム番号(ASN)で識別)が新しい PlanGroup エントリを追加できるようにします。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

lastUpdatedTime

string (Timestamp format)

データプラン エージェント(DPA)がバックエンド システムからデータプランのステータス情報を取得した時間。データプランのステータス情報の新しさを判断するために使用されます。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

認可スコープ

次の OAuth スコープが必要です。

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

詳細については、OAuth 2.0 の概要をご覧ください。