Method: operators.planGroups.create

تتيح لمشغّل شبكة جوّال (يتم تعريفه من خلال رقم النظام المستقل الفريد (ASN)) إضافة إدخال PlanGroup جديد.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل الترميز gRPC.

مَعلمات المسار

المعلمات
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.