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 の概要をご覧ください。