Offer

تفاصيل خطط البيانات في العرض الذي يتم تمديده للمستخدم

تمثيل JSON
{
  "planName": string,
  "planId": string,
  "planDescription": string,
  "promoMessage": string,
  "overusagePolicy": enum (OverUsagePolicy),
  "maxRateKbps": string,
  "cost": {
    object (Money)
  },
  "duration": string,
  "offerContext": string,
  "trafficCategories": [
    enum (PlanModuleTrafficCategory)
  ],
  "connectionType": enum (ConnectionType),
  "refreshPeriod": enum (RefreshPeriod),
  "offerType": enum (OfferType),

  // Union field quota can be only one of the following:
  "quotaBytes": string,
  "quotaMinutes": integer
  // End of list of possible types for union field quota.
}
الحقول
planName

string

مطلوب. سلسلة تحدّد العرض للمستخدم.

planId

string

مطلوب. سلسلة فريدة يمكن استخدامها لتحديد العرض بشكل فريد وإجراء عملية شراء لاحقًا إذا أراد المستخدم ذلك.

planDescription

string

مطلوب. سلسلة أطول تصف العرض للمستخدم.

promoMessage

string

سلسلة تصف العرض الترويجي.

overusagePolicy

enum (OverUsagePolicy)

يحدّد هذا الحقل ما يحدث إذا استخدم المستخدم بيانات أكثر من الكمية المقدَّمة. الخيارات المتاحة حاليًا هي: الحدّ من الاستخدام، والحظر، والدفع حسب الاستخدام الذي يخصم الرصيد من حساب المستخدم.

maxRateKbps

string (int64 format)

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

cost

object (Money)

مطلوب. تكلفة هذه الخطة

duration

string (Duration format)

عدد الثواني التي تكون فيها الخطة صالحة بعد تفعيلها

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".

offerContext

string

سياق العرض، ويُستخدَم في رسالة TransactionRequest.

trafficCategories[]

enum (PlanModuleTrafficCategory)

قائمة بفئات الزيارات التي سيتم تحصيل رسومها مقابل وحدة الخطة هذه

connectionType

enum (ConnectionType)

نوع الاتصال الذي تم تمديده كجزء من هذا العرض

refreshPeriod

enum (RefreshPeriod)

تمثّل هذه السمة فترة إعادة تحميل عرض الخطة هذا، أو REFRESH_PERIOD_NONE إذا كانت الخطة لا تعيد تحميل حصتها. ستتم إعادة ضبط الحصة مرة واحدة كل فترة إعادة ضبط.

offerType

enum (OfferType)

تحديد نوع العرض استنادًا إلى نوع العرض الترويجي، يمكن للعميل تخصيص تجربة المستخدم عند شراء العرض الترويجي.

حقل الدمج quota معلومات حصة الخطة، ويجب أن تكون إحدى القيمتين التاليتين: quota_bytes أو quota_minutes. يمكن أن تكون quota إحدى القيم التالية فقط:
quotaBytes

string (int64 format)

حصة الحزمة بالبايت

quotaMinutes

integer

حصة الحزمة بالدقائق