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', עם רזולוציה של ננו-שנייה ועד תשע ספרות אחרי הנקודה העשרונית. דוגמאות: "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.