Method: operators.planGroups.create

Ermöglicht einem Mobilfunkanbieter, der durch seine eindeutige Autonomous System Number (ASN) identifiziert wird, einen neuen PlanGroup-Eintrag hinzuzufügen.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Der Ressourcenname der übergeordneten Ressource im folgenden Format: operators/{asn_id}.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "planGroupId": string,
  "planGroup": {
    object (PlanGroup)
  }
}
Felder
planGroupId

string

Die planGroupId, die einen Abonnenten gegenüber dem Mobilfunkanbieter eindeutig identifiziert. Zum Beispiel kann „planGroupId“ die internationale Abonnentenverzeichnisnummer (MSISDN) oder eine verschlüsselte Version von MSISDN sein.

planGroup

object (PlanGroup)

Die zu erstellende PlanGroup-Ressource.

Antworttext

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

PlanGroup enthält Details zu allen mobilen Servicepaketen auf oberster Ebene, die ein Nutzer gekauft hat.

JSON-Darstellung
{
  "name": string,
  "dataPlans": [
    {
      object (Plan)
    }
  ],
  "responseStaleTime": string,
  "lastUpdatedTime": string
}
Felder
name

string

Der Ressourcenname der Plangruppe im folgenden Format: operators/{asn_id}/planGroups/{planGroupId}. Der Name wird beim Erstellen eines PlanGroup-Eintrags ignoriert.

dataPlans[]

object (Plan)

Liste der Datentarife, die diesem Nutzer gehören.

responseStaleTime

string (Timestamp format)

Zeit, in der die Informationen zur Gruppe des freigegebenen Plans veraltet sind. PlanGroup wird nach diesem Zeitraum nicht mehr für Anwendungen bereitgestellt.

Ein Zeitstempel im Format RFC3339 UTC mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

lastUpdatedTime

string (Timestamp format)

Zeitpunkt, zu dem der Datenplan-Agent (DPA) die Datenstatus-Informationen des Back-End-Systems abgerufen hat. Wird verwendet, um zu ermitteln, wie aktuell die Statusinformationen des Datentarifs sind.

Ein Zeitstempel im Format RFC3339 UTC mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0.