Method: operators.planGroups.create

Ermöglicht einem Mobilfunkanbieter (identifiziert durch seine eindeutige Autonomous System Number (ASN)), 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 eindeutig beim Mobilfunkanbieter identifiziert. planGroupId kann beispielsweise die MSISDN (Mobile Station International Subscriber Directory Number) oder eine verschlüsselte Version der 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 Mobilfunkdienstpaketen der obersten Ebene, die ein Nutzer erworben 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 Datenvolumen, die diesem Nutzer gehören.
responseStaleTime

string (Timestamp format)

Zeitpunkt, zu dem die Informationen zur freigegebenen Plangruppe veraltet sind. Nach diesem Zeitpunkt wird PlanGroup nicht mehr für Anwendungen bereitgestellt.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich 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 DPA (Data Plan Agent) die Statusinformationen zum Datenvolumen von Backend-Systemen abgerufen hat. Wird verwendet, um zu ermitteln, wie aktuell die Informationen zum Status des Datentarifs sind.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich 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 in der OAuth 2.0-Übersicht.