- المرجع: PlanStatus
- تمثيل JSON
- الخطة
- PlanCategory
- PlanUnit
- ByteQuota
- الحصة الزمنية
- BALANCELevel
- PlanUnittrafficCategory
- سياسة الاستخدام الزائد
- PlanState
- فترة التحديث
- معلومات الحساب
- مال
- AccountAccountStatus
- التوافق
- NotificationType
- PlanInfoPerClient
- YouTube
- Rateالبث المباشر
- AndroidSystemInfo
- CellularCellular (بيانات شبكة الجوّال)
- ConnectionType (نوع الاتصال)
- القياس
- CvidState
- الطُرق
المورد: PlanStatus
تتضمّن حالة الخطة تفاصيل جميع حِزم خدمات الأجهزة الجوّالة ذات المستوى الأعلى التي اشتراها المستخدم.
تمثيل JSON | |
---|---|
{ "name": string, "plans": [ { object ( |
الحقول | |
---|---|
name |
اسم مورد حالة الخطة بالتنسيق التالي: |
plans[] |
قائمة الخطط التي يملكها هذا المستخدم. |
languageCode |
مطلوبة. رمز اللغة BCP-47، مثل "en;US" أو "sr-Latn" لمزيد من المعلومات، يمكنك الاطّلاع على http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. |
expireTime |
مطلوبة. الوقت الذي تصبح فيه معلومات مجموعة الخطة المشتركة قديمة. ولن يتم عرض بيانات حالة الخطة في التطبيقات بعد هذا التاريخ. يجب أن يكون وقت انتهاء الصلاحية في المستقبل. طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسور. أمثلة: |
updateTime |
مطلوبة. الوقت الذي جلب فيه وكيل خطة البيانات (DPA) معلومات حالة الخطة من الأنظمة الخلفية يمكن استخدام هذه البيانات لتحديد مدى حداثة معلومات حالة الخطة. ويجب أن يكون وقت التعديل في الماضي ولكن لا يمكن أن يتجاوز عمره 30 يومًا. طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسور. أمثلة: |
title |
اسم العقد الذي أبرمه المستخدم مع عامل التشغيل سيتم عرض هذا العنوان في عنوان واجهة المستخدم. |
subscriberId |
معرّف ثابت وفريد في نظام مشغّل شبكة الجوّال لتحديد هوية المستخدم |
accountInfo |
مطلوب لمستخدمي الإصدار المدفوع مسبقًا. معلومات عن رصيد حساب المستخدم |
uiCompatibility |
يُحدِّد هذا الإعداد ما إذا كان يمكن عرض حالة الحالة للمستخدم في واجهة مستخدم. عند الضبط على UI_INCOMPATIBLE، يمكن استخدام حالة الحالة لإرسال إشعارات إلى المستخدم، ولكن لن يتم استخدامها لعرض معلومات الخطة للمستخدم. |
notifications[] |
يحتوي على قائمة أنواع الإشعارات التي أرسلها المستخدم إلى GTAF. يتجاهل GTAF هذا الحقل إذا تمت تعبئته بواسطة المتصل. |
planInfoPerClient |
معلومات خطة البيانات ذات الصلة بعميل Google معيّن. |
cpidState |
حالة CPID المرتبطة بحالة الخطة هذه. |
الخطة
تفاصيل خطة الجوّال للمستخدم، وهي عبارة عن حزمة خدمة أعلى مستوى للجوّال يشتريها المشترك. يمكن أن تكون الخطة بسيطة مثل "و"10 غيغابايت من بيانات الجوّال لمدة 30 يومًا" أو يمكن تحديدها كمجموعة من المكونات (التي نشير إليها باسم وحدات الخطة). على سبيل المثال، تحتوي خطة ACME 199 الموضّحة على أنّها "بيانات 2 غيغابايت"، وعدد غير محدود من محادثات WhatsApp وسعة تخزين غير محدودة على Wechat، ومعاينة 1 غيغابايت من Spotify، وثلاث وحدات للخطة.
تمثيل JSON | |
---|---|
{ "planName": string, "planId": string, "planCategory": enum ( |
الحقول | |
---|---|
planName |
اسم خطة الجوّال للمستخدم. |
planId |
مطلوبة. معرّف الخطة، يُستخدم للإشارة إلى الخطة أثناء العروض، إلخ. |
planCategory |
خطة دفع مُسبَق أو دفع عند الاستخدام |
expirationTime |
مطلوبة. عند انتهاء صلاحية هذه الخطة وبالنسبة إلى معظم الخطط، يجب أن يكون ذلك مساويًا للحد الأقصى من جميع أوقات انتهاء الصلاحية الخاصة بوحدة الخطة. بالنسبة إلى الخطط التي تُعيد تحميل حصة الوحدة بشكلٍ دوري، يجب أن يكون الوقت الإجمالي لانتهاء صلاحية الخطة هو الوقت الذي تتوقّف فيه إعادة تحميل وحدات الخطة. يجب حذف هذا الحقل في حال عدم انتهاء صلاحية الخطة. طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسور. أمثلة: |
planModules[] |
معلومات تفصيلية عن خطط الخطة (الخطط الفرعية). |
planState |
حالة خطة المستخدم، مثل نشط وغير نشط وما إلى ذلك. |
فئة الخطة
أنواع فئات الخطط المحتملة.
عمليات التعداد | |
---|---|
PLAN_CATEGORY_UNSPECIFIED |
غير محدد |
PREPAID |
خطة دفع مُسبَق |
POSTPAID |
خطة دفع مُسبَق |
وحدة الخطة
معلومات عن كل وحدة خطة بيانات (أو خطة فرعية) داخل خطة.
تمثيل JSON | |
---|---|
{ "coarseBalanceLevel": enum ( |
الحقول | ||
---|---|---|
coarseBalanceLevel |
معلومات الرصيد التقريبي |
|
trafficCategories[] |
قائمة بفئات الزيارات التي سيتم تحصيلها مقابل وحدة الخطة هذه. |
|
expirationTime |
مطلوبة. وقت انتهاء الصلاحية المحدّد لوحدة الخطة بالنسبة إلى وحدات الخطة ذات الحصة التي تتم إعادة تحميلها بشكل دوري، يكون هذا هو وقت إعادة تحميل الوحدة التالية. يجب حذف هذا الحقل في حال عدم انتهاء صلاحية وحدة الخطة. طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسور. أمثلة: |
|
overUsagePolicy |
سياسة الاستخدام الزائد، مثل تقييد تدفق البيانات. |
|
maxRateKbps |
الحد الأقصى لمعدل البيانات الذي تسمح به وحدة الخطة هذه بالكيلوبت في الثانية. ويتراوح معدل البيانات الفعلي الذي يتم رصده بين 0 وmaxRateKbps، وذلك حسب ظروف الشبكة. يشير إغفال maxRateKbps أو ضبطها على 0 إلى عدم تنفيذ التقييد لوحدة الوحدة هذه. |
|
description |
مطلوبة. وصف وحدة الخطة، يمكن أن يظهر للمستخدم، ويجب أن يكون قريبًا من وصف السوق لوحدة الخطة هذه. |
|
moduleName |
مطلوبة. اسم وحدة الخطة. |
|
usedBytes |
إجمالي عدد وحدات البايت التي يستخدمها المستخدم من وحدة الخطة هذه. |
|
planModuleState |
حالة وحدة الخطة، مثل نشطة وغير نشطة وما إلى ذلك |
|
refreshPeriod |
فترة إعادة التحميل لوحدة الخطة هذه، أو REFRESH_PERIOD_NONE في حال عدم إعادة تحميل وحدة الخطة لحصتها. نفّذ وحدات الوحدات التي تتم إعادة تحميل الحصة فيها مرة واحدة كل فترة إعادة تحميل. |
|
حقل الاتحاد balance . مطلوبة. يجب أن تكون معلومات رصيد وحدة الخطة إحدى القيم التالية: byte_balance, time_balance, coarse_balance_level. يمكن أن يكون balance واحدًا فقط مما يلي: |
||
byteBalance |
معلومات حول رصيد وحدة الخطة المستندة إلى بايت. بالنسبة إلى الوحدات التي تتم إعادة تحميلها بشكل دوري، يمثل هذا الحقل رصيد وحدات البايت لكل فترة إعادة تحميل. |
|
timeBalance |
معلومات حول رصيد وحدة الخطة المستندة إلى الوقت. بالنسبة إلى الوحدات التي تتم إعادة تحميلها بشكل دوري، يمثل هذا الحقل الرصيد الزمني لكل فترة إعادة تحميل. |
وحدات البايت
معلومات حول حصة/رصيد وحدة الخطة المستندة إلى بايت.
تمثيل JSON | |
---|---|
{ "quotaBytes": string, "remainingBytes": string } |
الحقول | |
---|---|
quotaBytes |
حصة الوحدة بالبايت. بالنسبة إلى الخطط غير المحدودة، يجب ضبط القيمة على 2^63 - 1 (9223372036854775807). |
remainingBytes |
مطلوب لإشعارات الرصيد المنخفض. رصيد الحصة المتبقي بالبايت. |
الحصة الزمنية
معلومات حول حصة/رصيد وحدة الخطة المستندة إلى الوقت.
تمثيل JSON | |
---|---|
{ "quotaMinutes": string, "remainingMinutes": string } |
الحقول | |
---|---|
quotaMinutes |
حصة الوحدة بالدقائق للخطة المستندة إلى الوقت، على سبيل المثال، 180 دقيقة |
remainingMinutes |
رصيد الحصة المتبقي بالدقائق للخطة المستندة إلى الوقت، على سبيل المثال، 40 دقيقة. |
مستوى التوازن
معلومات ميزان بيانات وحدة الخطة التقريبي
عمليات التعداد | |
---|---|
BALANCE_LEVEL_UNSPECIFIED |
غير محدد |
NO_PLAN |
ما مِن خطة بيانات. |
OUT_OF_DATA |
رصيد البيانات هو صفر. |
LOW_QUOTA |
يساوي رصيد البيانات (أو الوقت المتبقي) 10-25% أو أقل من رصيد الحزمة الأصلي (أو الوقت). ويمكن أن تحدّد شركات النقل الحدّ الأدنى لكلّ حزمة على النحو الذي تراه مناسبًا. |
HIGH_QUOTA |
رصيد البيانات (أو الوقت المتبقي) أكبر من 10-25% من رصيد الحزمة الأصلي (أو الوقت). ويمكن أن تحدّد شركات النقل الحدّ الأدنى لكلّ حزمة على النحو الذي تراه مناسبًا. رصيد البيانات مرتفع. |
بلا وحدة وحدة بيانات
فئة زيارات وحدة الخطة التي تصف مجموعة زيارات التطبيقات التي تندرج ضمن وحدة خطة معيّنة.
عمليات التعداد | |
---|---|
PLAN_MODULE_TRAFFIC_CATEGORY_UNSPECIFIED |
غير محدد |
GENERIC |
عام، ينطبق على جميع الزيارات. |
VIDEO |
كل حركات بيانات الفيديو |
VIDEO_BROWSING |
عدد زيارات video discovery (التصفّح) التي تشير إلى جميع زيارات تطبيقات الفيديو باستثناء جزء بث الفيديو/الصوت |
VIDEO_OFFLINE |
زيارات الفيديو بلا اتصال بالإنترنت، وهي مجموع عدد VIDEO_BROWSING وعدد زيارات الفيديو/الصوت بلا اتصال بالإنترنت (بدون بث). |
MUSIC |
زيارات تطبيق الموسيقى |
GAMING |
زيارات تطبيقات الألعاب |
SOCIAL |
زيارات التطبيقات الاجتماعية. |
MESSAGING |
الزيارات من تطبيق المراسلة. |
APP_STORE |
زيارات متجر التطبيقات، مثل تعديل تطبيق جديد أو تنزيله. |
سياسة الاستخدام الزائد
سياسة الاستخدام الزائد: ما يحدث عند نفاد حصة المستخدم.
عمليات التعداد | |
---|---|
OVER_USAGE_POLICY_UNSPECIFIED |
غير محدد |
THROTTLED |
ويتم تقييد السرعة. |
BLOCKED |
تم حظر الاتصال. |
PAY_AS_YOU_GO |
الدفع مقابل الاستخدام. |
حالة النظام
يمثّل Enum حالة مختلفة لوحدة خطة/خطة المستخدم.
عمليات التعداد | |
---|---|
ACTIVE |
الخطة/الوحدة التنظيمية نشطة ويمكن للمستخدم استخدام البيانات المقدَّمة كجزء من الوحدة. |
INACTIVE |
وحدة الخطة/الخطة غير نشطة، وفي حين أن المستخدم لا يزال يحتوي على الوحدة، لا يمكن للمستخدم استخدام بيانات وهي جزء من الوحدة. قد يحدث هذا فقط إذا كانت الوحدة تعرض البيانات خلال أوقات معينة من اليوم أو إذا اشترى المستخدم وحدة ولكن لم يتم تفعيلها بعد. |
EXPIRING_SOON |
ستنتهي صلاحية الخطة/الوحدة النموذجية قريبًا. على المُتصِل اختيار مستوى مناسب لتحديد وقت ضبط هذه القيمة. ويعني هذا أنّ الخطة نشطة تلقائيًا. |
NEWLY_ACTIVE |
تم تفعيل خطة/PlanUnit التي كانت غير نشطة أو غير موجودة سابقًا. يجب استخدام هذه الحالة لفترة قصيرة جدًا بعد وقت التفعيل، وإلا يجب استخدام الحالة "نشط" بدلاً من ذلك. يجب إرسال إشعارات حالة خطة البيانات المُرسَلة مع وحدات NEWLY_ACTIVE مع مدة قصيرة (TTL)، نظرًا لأن الحالة NEWLY_ACTIVE غير دقيقة بسرعة كبيرة. |
EXPIRED |
انتهت صلاحية الخطة/الوحدة التنظيمية. يؤدي ضبط قيمة الإحصاء هذه إلى إرسال إشعار انتهت صلاحية الخطة. |
فترة إعادة التحميل
ويمثل ذلك فترة إعادة التحميل، والفاصل الزمني المعتاد الذي تتم فيه إعادة ضبط وحدة الخطة.
عمليات التعداد | |
---|---|
REFRESH_PERIOD_NONE |
ليست هناك فترة إعادة تحميل. تُستخدم هذه السياسة عندما لا تكون وحدة الخطة متكررة. |
DAILY |
تتم إعادة ضبط وحدة الخطة كل يوم. |
MONTHLY |
تتم إعادة ضبط وحدة الخطة كل شهر. |
BIWEEKLY |
تتم إعادة ضبط وحدة الخطة كل أسبوعين. |
WEEKLY |
تتم إعادة ضبط وحدة الخطة كل أسبوع. |
معلومات الحساب
معلومات عن رصيد حساب المستخدم المدفوع مسبقًا.
تمثيل JSON | |
---|---|
{ "accountBalance": { object ( |
الحقول | |
---|---|
accountBalance |
مطلوبة. رصيد الحساب المتبقي في حساب المستخدم. |
loanBalance |
مطلوبة إذا كانت منطبقة. رصيد الحساب المتبقي على حساب المستخدم الذي تمت إضافته عبر قرض مالي من مشغّل شبكة الجوّال. لا يتضمّن حقل "رصيد الحساب" هذا الرصيد في حال توفّره. |
unpaidLoan |
المبلغ المالي الذي يدين به المستخدم لمشغّل شبكة الجوّال بسبب القروض المالية. |
accountBalanceStatus |
مطلوبة. تشير إلى حالة رصيد الحساب. وفي حال عدم التطابق بين حقل validUntil time وaccountCreditStatus، نستخدم accountBALANCEStatus. |
validUntil |
مطلوبة. الوقت الذي يكون فيه رصيد الحساب صالحًا. سيُستخدم هذا الحقل لعرض "،غير صالح في طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسور. أمثلة: |
payAsYouGoCharge |
المبلغ الذي أنفقه المستخدم من خلال استخدام الخطة في الدفع حسب الاستخدام. إذا تمت تعبئة هذا الحقل من قِبل مشغّل شبكة الجوّال عند مشاركة معلومات الحساب مع GTAF، سيحاول GTAF إرسال إشعار إلى المستخدم يشير إلى أنه ينفق أموالاً أثناء الدفع. |
accountTopUp |
مطلوب لإشعار إضافة رصيد للحساب. مبلغ الأموال التي أضافها المستخدم إلى رصيد حسابه. إذا تمت تعبئة هذا الحقل من قِبل مشغّل شبكة الجوّال عند مشاركة معلومات الحساب مع GTAF، سيحاول GTAF إرسال إشعار إلى المستخدم يشير إلى أنه تم إضافة رصيد إلى حسابه. |
مال
يُمثِّل مبلغًا من المال بنوع العملة.
تمثيل JSON | |
---|---|
{ "currencyCode": string, "units": string, "nanos": integer } |
الحقول | |
---|---|
currencyCode |
تمثّل هذه السمة رمز العملة المكوَّن من 3 أحرف والمحدَّد في ISO 4217. |
units |
تمثّل هذه السمة الوحدات الكاملة للمبلغ. على سبيل المثال، إذا كانت |
nanos |
عدد وحدات النانو (10^-9) من المبلغ. يجب أن تتراوح القيمة بين -999,999,999 و+999,999,999 شاملة. إذا كانت قيمة |
حالة رصيد الحساب
حالة محفظة المستخدم.
عمليات التعداد | |
---|---|
VALID |
رصيد حساب المستخدم صالح ويمكن استخدامه لإجراء عمليات شراء. |
INVALID |
رصيد حساب المستخدم غير صالح ولا يمكن استخدامه بدون إجراء تغييرات على الحساب. |
التوافق مع الاستخدام
تشير هذه القيمة إلى ما إذا كان يمكن عرض "حالة الخطة" التي تتم مشاركتها للمستخدم.
عمليات التعداد | |
---|---|
UI_COMPATIBILITY_UNSPECIFIED |
سنفترض بشكل تلقائي أنّ حالة الحالة متوافقة مع واجهة المستخدم. |
UI_COMPATIBLE |
تشير هذه القيمة إلى أنّ حالة الخطة بالكامل متوافقة مع واجهة المستخدم ويمكن عرض معلومات الخطة للمستخدم. |
UI_INCOMPATIBLE |
تشير إلى أن حالة الحالة لا تتوافق مع واجهة المستخدم. يمكن استخدام الحقول لإرسال الإشعارات إلى المستخدم، ولكن لا يمكن استخدامها لعرض معلومات الخطة للمستخدم. |
نوع الإشعار
نوع الإشعار الذي يتم إرساله إلى مستخدم إعدادات خطة بيانات الجوّال.
عمليات التعداد | |
---|---|
NOTIFICATION_UNDEFINED |
نوع نوع الإشعار غير معروف |
NOTIFICATION_LOW_BALANCE_WARNING |
إشعار يحذّر المستخدمين من انخفاض الرصيد |
NOTIFICATION_DATA_EXPIRATION_WARNING |
إشعار يحذّر المستخدمين من أنّ صلاحية خطة البيانات ستنتهي |
NOTIFICATION_OUT_OF_DATA |
إشعار بنفاد البيانات لدى المستخدمين |
NOTIFICATION_PLAN_ACTIVATION |
إشعار بأن خطة المستخدم التي تم شراؤها نشطة الآن |
NOTIFICATION_PAY_AS_YOU_GO |
إشعار يُعلِم المستخدم بأنّه يدفع رسوم بيانات أثناء الدفع. |
NOTIFICATION_ACCOUNT_TOP_UP |
إشعار لإبلاغ المستخدم بأنه تمت إضافة رصيد إلى رصيد حسابه. |
NOTIFICATION_DATA_EXPIRED |
إشعار يبلغ المستخدم بانتهاء صلاحية خطة البيانات. |
خطة معلومات العميل
معلومات خطة البيانات ذات الصلة بعميل Google معيّن.
تمثيل JSON | |
---|---|
{ "youtube": { object ( |
الحقول | |
---|---|
youtube |
معلومات حول الخطة ذات الصلة في YouTube |
androidSystemInfo |
معلومات الخطة ذات الصلة بنظام Android |
YouTube
معلومات حول خطة البيانات المرتبطة بمنصة YouTube
تمثيل JSON | |
---|---|
{
"rateLimitedStreaming": {
object ( |
الحقول | |
---|---|
rateLimitedStreaming |
ميزة بث الوعي في YouTube الخطة التي تحدّ من معدل نقل بيانات الفيديو الذي يتم عرضه. |
معدّل البث محدود
معلومات خطة البيانات لتمكين YouTube من تحسين تجربة المستخدم خلال البث المحدود.
تمثيل JSON | |
---|---|
{ "maxMediaRateKbps": integer } |
الحقول | |
---|---|
maxMediaRateKbps |
معدّل نقل البيانات على YouTube المتوافق مع هذا المستخدم بالكيلوبت في الثانية (1000's من وحدات البت في الثانية) |
معلومات نظام Android
معلومات خطة البيانات ذات الصلة بنظام Android بالكامل
تمثيل JSON | |
---|---|
{
"cellularInfo": [
{
object ( |
الحقول | |
---|---|
cellularInfo[] |
معلومات شبكة الجوّال حسب نوع الاتصال. على سبيل المثال، سيكون هناك رسالة شبكة جوّال واحدة لكل نوع اتصال، مثل 4G و5G وما إلى ذلك. |
معلومات شبكة الجوّال
معلومات عن اتصال شبكة الجوّال الذي توفّره الخطة للمستخدم.
تمثيل JSON | |
---|---|
{ "connectionType": enum ( |
الحقول | |
---|---|
connectionType |
نوع الاتصال الذي يوفره عامل التشغيل للمستخدم. |
meteredness |
حالة الحدّ الأقصى المسموح به لخطة المستخدم |
نوع الاتصال
نوع الاتصال: 2G و3G و4G
عمليات التعداد | |
---|---|
CONNECTION_TYPE_UNSPECIFIED |
غير محدد |
CONNECTION_2_G |
شبكة الجيل الثاني (2G). |
CONNECTION_3_G |
شبكة الجيل الثالث |
CONNECTION_4_G |
شبكة الجيل الرابع (4G) |
CONNECTION_5_G |
شبكة الجيل الخامس (5G) |
CONNECTION_ALL |
جميع الأنواع. |
القياس
نوع الخطة التي يمتلكها المستخدم
عمليات التعداد | |
---|---|
METEREDNESS_UNSPECIFIED |
لا تتوفّر في "أداة مزامنة دليل Google Cloud" حالة قياس الحدّ الأقصى المسموح به لخطة المستخدم. |
METEREDNESS_UNMETERED |
المستخدم مشترك في خطة لا تفرض تكلفة استخدام. |
METEREDNESS_METERED |
المستخدم مشترك في خطة تفرض تكلفة استخدام. |
CpeState
تعداد لشركة النقل يمثّل حالة CPID.
عمليات التعداد | |
---|---|
CPID_STATE_UNSPECIFIED |
لم يتم تحديد حالة CPID. يتم التعامل مع هذه القاعدة كما لو كانت قيمة CPID صالحة. |
CPID_INVALIDATED |
معرّف CPID غير صالح، ويجب على العميل جلب معرّف CPID جديد من نقطة نهاية CPID. |
الطُرق |
|
---|---|
|
يسمح هذا الإعداد لمشغّل الأجهزة الجوّالة (الذي يحدّده رقم النظام المستقل (ASN)) بإضافة إدخال PlanStatus جديد ليستخدِمه عميل معيّن. |