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

الخطةGroupId، التي تحدّد مشتركًا فريدًا لمشغّل شبكة الجوّال على سبيل المثال، planGroupId يمكن أن يكون رقم دليل المشتركين الدوليين (MSISDN) أو نسخة مشفّرة من MSISDN.

planGroup

object (PlanGroup)

مورد PlanGroup المطلوب إنشاؤه.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تحتوي خطة GroupGroup على تفاصيل لجميع حِزم خدمات الأجهزة الجوّالة ذات المستوى الأعلى التي اشتراها المستخدم.

تمثيل 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)

الوقت الذي تصبح فيه معلومات مجموعة الخطة المشتركة قديمة. ولن يتم عرض خطة GroupGroup على التطبيقات بعد هذا الوقت.

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقّة تصل إلى نانوثانية. مثال: "2014-10-02T15:01:23.045123456Z"
lastUpdatedTime

string (Timestamp format)

الوقت الذي جلب فيه وكيل خطة البيانات (DPA) معلومات حالة خطة البيانات من أنظمة الخلفية ستُستخدم لتحديد مدى حداثة معلومات حالة خطة البيانات.

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقّة تصل إلى نانوثانية. مثال: "2014-10-02T15:01:23.045123456Z"

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

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

للحصول على مزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على OAuth 2.0.