بدء مشاركة خطة بيانات الجوّال

مصطلحات

• GTAF: وظيفة تطبيق عدد زيارات Google. خدمة من Google تنفذ واجهة برمجة التطبيقات لمشاركة خطة البيانات وتتفاعل مع DPA نيابةً عن تطبيقات Google. يمكن لتطبيقات Google إجراء طلبات بحث في GTAF للحصول على معلومات خطة بيانات المستخدم. بدلاً من ذلك، إذا كانت تطبيقات Google مسجَّلة لدى GTAF، يمكن أن يرسل تطبيق GTAF تحديثات حول خطة بيانات المستخدم.
• MSISDN: رقم الدليل المشترك للمشتركين في الأجهزة الجوّالة، وهو رقم يُعرّف عن الاشتراك بشكل فريد في شبكة الجوّال. يُعرف عادةً باسم "رقم الهاتف".
• نقطة نهاية CPID: خدمة يتم تنفيذها من قِبل مشغّلي شبكات الجوّال الذين ينشئون معرّف خطة مشغّل شبكة الجوّال (CPID) الذي يمكن استخدامه للبحث عن معلومات خطة بيانات المستخدم. يسمح CPID للتطبيق بالاستعلام عن تفاصيل خطة بيانات المستخدم بدون الوصول إلى MSISDN الخاص بالمستخدم. نوضّح أدناه وصف إنشاء معرّفات CPID.
• مفتاح المستخدم: مفتاح المستخدم هو سلسلة يمكن استخدامها لتحديد خطة بيانات للمستخدمين. ويمكن أن يكون هذا الرقم CPID أو MSISDN للتطبيقات التي يمكنها الوصول إلى MSISDN.
• تعديل بنود معالجة البيانات: هي أداة خطة بيانات يتم تنفيذها من قِبل مشغّلات شبكة الجوّال التي تشارك معلومات خطة بيانات المستخدم مع GTAF. يمكن لـ "هيئة حماية البيانات" مشاركة معلومات مع "مدير إعلانات Google" باستخدام مجموعة من إرسال البيانات باستخدام واجهة برمجة التطبيقات لمشاركة خطة بيانات الجوّال من Google وتنفيذ واجهة برمجة تطبيقات وكيل خطة البيانات. يمكنك أيضًا استخدام "تعديل بنود معالجة البيانات" كنقطة نهاية CPID أيضًا.
• UE: معدات المستخدم، الجهاز الذي يستخدمه المستخدم.

لغة المتطلبات

الكلمات الرئيسية "MUST", &&;;RUST NOT", "required", "SHALL"&&;;SHALL NOT", "SHOULD", &##;SHOULD NOT", "RECOMMENDED", "MAY",][ar, inquot; intitle in in توقّعنا

مشاركة خطة بيانات الجوّال

على مستوى عالٍ، تتألف مشاركة خطة بيانات الجوّال من ثلاثة أجزاء:

1. آلية لإنشاء معرّف خطة مشغّل شبكة الجوّال (CPID) وتعديله، والذي يمكن استخدامه كمفتاح مستخدم. يمكن للتطبيقات التي يمكنها الوصول إلى MSISDN أن تستخدمها MSISDN باعتبارها مفتاح مستخدم.
2. واجهة برمجة تطبيقات مشاركة خطة بيانات Google للأجهزة الجوّالة التي تتيح لهيئة حماية البيانات إرسال معلومات عن خطة بيانات المستخدم إلى Google. على سبيل المثال، إذا أرادت "هيئة حماية البيانات" إعلام المستخدم بعرض معيّن، يمكنها إرسال إشعار إلى GTAF الذي يُعلِم المستخدم بدوره.
3. واجهة برمجة تطبيقات وكيل خطة بيانات يتم تنفيذها من خلال "هيئة حماية البيانات" والتي تسمح للائحة العامة لحماية البيانات بالاستعلام عن "تعديل بنود معالجة البيانات" للحصول على معلومات عن خطة بيانات المستخدم. على سبيل المثال، إذا أراد التطبيق عرض رصيد خطة البيانات الحالي إلى المستخدم، يمكنه إرسال طلب بحث إلى GTAF الذي بدوره يؤدي إلى طلبات بحث هيئة حماية البيانات.

يقدّم الجزء المتبقي من هذه الصفحة مصطلحات خطة البيانات، كما يقدّم تفاصيل عن كيفية إنشاء CPID. واجهة برمجة التطبيقات لمشاركة خطة بيانات Google للأجهزة الجوّالة ومواصفات واجهة برمجة التطبيقات لوكيل بيانات البيانات هي الخطوة التالية.

مصطلحات خطة البيانات

يجب أن يتمكن مخطط PlanStatus المحدد في واجهة برمجة التطبيقات من تمثيل خطط البيانات التي يقدمها المُشغّلون للمستخدمين. تتيح واجهة برمجة التطبيقات تحديد خطط البيانات التي تحصّل رسومًا من المستخدمين بمعدّل مختلف لجميع الزيارات إلى مجموعة معيّنة من عناوين URL (على سبيل المثال، يتم تحصيل رسوم مقابل كل الزيارات إلى *.acmefake.com بمعدل مختلف). وتدعم واجهة برمجة التطبيقات أيضًا خطط البيانات التي توفّر أسعارًا مختلفة لأنواع معيّنة من الإجراءات في التطبيق. ونُطلق على خطط بيانات التطبيقات الفرعية هذه مثالاً على خطة بيانات التطبيقات الفرعية. وهي تتمثل في توفير تصفُّح الفيديو مجانًا (أي معدّل صفر). وأثناء مشاهدة الفيديوهات ضمن التطبيق، يتم خصم البيانات من رصيد البيانات الخاص بالمشتركين. يجب أن يتمكّن تطبيق الفيديو بعد ذلك من معرفة هذه المعلومات عند البحث عن معلومات خطة البيانات.

في ما يلي بعض العبارات المرتبطة بخطط البيانات. يوفر الشكل 1 أمثلة لخطط البيانات التي تمثل المفاهيم التي نريد تسجيلها.

خطة البيانات: حزمة الخدمة ذات المستوى الأعلى على الأجهزة الجوّالة التي يشتريها المشترك. ويمكن أن تكون هذه العملية بسيطة مثل "بيانات 10 غيغابايت للأجهزة الجوّالة" لمدة 30 يومًا، أو يمكن تحديدها كمجموعة مكوّنات تُعرف أيضًا باسم "الوحدات". تشمل خطة البيانات ما يلي:

• اسم خطة البيانات، مثل "ACME Red"
• معرّف خطة البيانات: يُستخدَم للإشارة إلى الخطة، مثلاً، أثناء عمليات الشراء.
• وقت انتهاء الصلاحية، عند انتهاء صلاحية خطة البيانات.
• فئة الخطة، سواء كانت الخطة هي خطة دفع مُسبَق أو خطة ما بعد الدفع.

وحدة الخطة: مكوّن في خطة بيانات. على وجه التحديد، تحتوي وحدة الخطة على:

• اسم الوحدة، مثل "ليل الفيديو المجاني" و"&quot.
• الحد الأقصى لمعدل نقل البيانات، وهو معدل نقل البيانات التي تقدمها للمستخدم من خلال هذه الوحدة.
• Flex Time Windows: الفترة الزمنية التي يمكن خلالها تقديم خصم للمستخدم.

• فئة زيارات وحدة الخطة (PMTC)، وهي وصف لعدد زيارات البيانات التي تنطبق عليها الوحدة. ويمكن أن تكون هذه العلامة عامة مثل *جميع زيارات الإنترنت *أو محددة مثل الزيارات التي تم إنشاؤها/استهلاكها من خلال تطبيق أو أكثر أو مواقع إلكترونية أو حتى رحلات المستخدم ضمن تطبيق واحد. ومن أمثلة هذا النوع الجديد: "&quot؛مقاصات غير محدودة للموسيقى،&"؛&&;&;;100 ميغابايت: حزمة بيانات الفيديو (VDP)"&"&";وبيانات الألعاب غير المحدودة"&";&&و;التصفّح غير المحدود للفيديوهات". لتسهيل تحديد هذه العلامات، حدّدنا النقاط التالية: GENERIC, VIDEO, VIDEO_BROWSING, VIDEO_OFFLINE¹, MUSIC, GAMING, SOCIAL, MESSAGING وPMTC_UNSPECIFIED.

• الحد الأقصى لحجم البيانات أو الحد الزمني، بعد تفعيله، تنتهي صلاحية وحدة الخطة عند تحديد حجم البيانات أو الحد الزمني (في حالة الخطط المستندة إلى الوقت، على سبيل المثال، تم تجاوز 600 دقيقة للاتصال بالإنترنت خلال الأيام السبعة المقبلة). في الشكل 1 أدناه، يمكن للمشترك شراء وحدة خطة، كجزء من "ACME Blue&quot، تقدّم 1 غيغابايت من زيارات المستخدمين العامة التي يجب استخدامها خلال أسبوع من تاريخ انتهاء الصلاحية.

الشكل 1. نماذج خطط البيانات

تحديد التكلفة في اليوم

تستخدم "أداة مزامنة دليل Google Cloud" مفتاح المستخدم لتحديد مشترك عند التواصل مع "هيئة حماية البيانات". يمكن للتطبيقات التي يمكنها الوصول إلى MSISDN الخاص بالمستخدم أن تستخدم هذا المفتاح باعتباره user_key. من ناحية أخرى، تحتاج التطبيقات التي لا يمكنها الوصول إلى MSISDN إلى إنشاء معرّف خطة مشغّل شبكة الجوّال (CPID) بدون التعرُّف على MSISDN. في ما يلي وصف للآلة التي تحدد معرّف CPID.

مسار مكالمة CPID

الشكل 2: مسار الاتصال لإنشاء معرِّف CPID.

1. يستخدم تطبيق Google في UE واجهة برمجة تطبيقات داخلية من Google لاسترداد عنوان URL لنقطة نهاية CPID من GTAF. يتم تحديد المشغّل باستخدام عنوان IP العلني للعميل، ورقم تعريف MNC ومركز عملائي لشريحة SIM النشطة. في حال MVNO، ستستخدم Google SPN وGID1 لتحديد MVNO.
2. يُصدِر البرنامج طلب HTTP GET إلى نقطة نهاية CPID. قد يتيح عامل التشغيل إرسال الطلب عبر HTTPS.
3. قد يستخدم عامل التشغيل MAY وظيفة "فحص الحزمة الداخلية" لتحديد طلب وإدخال رقم هاتف المستخدم في الطلب كرأس HTTP.
4. تتلقّى نقطة نهاية CPID الطلب ويتم إنشاء معرّف CPID وعرض CPID مع UE مع مدة بقاء (TTL) تشير إلى المدة التي يمكن أن يستخدمها UE خلالها.

قد يستخدم المُشغِّل أيضًا عناوين IP بدلاً من أسماء النطاقات في عنوان URL لنقطة نهاية CPID، إذا كان ذلك ممكنًا. قد تكون عناوين IP في نطاق العنوان الخاص، ولكن يجب أن يتمكن عملاء Google من الوصول إليها داخل شبكة عوامل التشغيل.

يقدِّم عامل التشغيل "ALL" المعلومات التالية إلى Google كجزء من عملية الإعداد: 1. معرّف CPID_URL الذي ستتواصل معه التطبيقات للحصول على معرّفات CPID. ويكون CPID_URL إلزاميًا، ولكن يمكن لمشغّل شبكة البحث تقديم عناوين URL متعددة لزيادة مدى توفّر العنصر. 1- قائمة بادئات عناوين IP التي يملكها مشغِّل شبكة الجوّال ورمز بلد الجوّال (MCC) ورمز شبكة الجوّال (MNC) الذي يريد الربط بين المشغِّل وعناوين CPID_URL المقدَّمة. إذا كان عامل التشغيل يستخدم SPN أو GID1 لتمييز MVNO في شبكته، يجب أن يقدّم المشغّل هذه المعلومات أيضًا. ستستخدم Google هذه المعلومات لمطابقة العملاء مع نقاط نهاية CPID المقابلة، كما هو موضّح في الخطوة 1 من الشكل 2.

تنسيق الطلب هو: GET CPID_URL لأسباب قديمة، يجب أن تتمكّن نقطة نهاية CPID من دعم طلب، مثل ما يلي:

GET CPID_URL?app={app_id}

يمكن أن تتجاهل نقطة نهاية CPID معلَمة عنوان URL التي تتضمّن {app_id} عند إنشاء CPID. ولكن يجب أن يتمكّن من معالجة طلب يحتوي على المَعلمة.

قد يتضمّن الطلب المُرسَل إلى نقطة نهاية CPID عنوان Accept-Language. في حال تضمين العنوان، حينئذٍ يمكن للمستخدمين قراءة السلاسل في التحديثات التي ترسلها "هيئة حماية البيانات" باستخدام واجهة برمجة التطبيقات لمشاركة خطة بيانات الجوّال، ويجب استخدام الإعدادات المقدَّمة في طلب CPID.

في كل مرة يُصدر فيها العميل طلب GET CPID_URL، يجب أن يتلقى معرِّف CPID جديدًا. في حال نجاح إنشاء معرِّف CPID، يجب أن تعرض نقطة نهاية CPID استجابة 200 OK. يجب أن يحتوي نص الاستجابة على مثال CPIDResponse.

{
    "cpid": "<CPID_string>",
    "ttlSeconds": 2592000
}

يجب أن يكون معرّف CPID المعروض صالحًا لمدة ttlبالثواني. ستعمل ترميز GTAF على ترميز CPID وفقًا لمعيار RFC2396 في الاستدعاءات اللاحقة لهيئة حماية البيانات.

في حال حدوث خطأ، يجب أن تعرض نقطة نهاية CPID خطأ HTTP مع نص استجابة يجب أن يحتوي على مثال من ErrorResponse. تتوفر قائمة السبب المحتملة وقيم خطأ HTTP هنا.

{
    "errorMessage": "<error message>",
    "cause": "INVALID_NUMBER"
}

وعلى وجه الخصوص، إذا تم تلقّي طلب CPID لمستخدم لا ينتمي إلى شبكة المشغّل (على سبيل المثال، مستخدم ينتمي إلى مشغّل آخر ولكنه يتجول على الشبكة التي تقدّمها نقطة نهاية CPID هذه) أو لم يوافق على مشاركة معلومات خطة البيانات مع Google، يجب أن تعرض نقطة نهاية CPID رمز حالة HTTP 403.

معرِّف CPID

في ما يلي الطريقة المُقترَحة لنقطة نهاية CPID لإنشاء معرِّف CPID:

CPID_string = Base64(AES(MSISDN + TimeStamp + language, secret))

تعمل نقطة نهاية CPID على ربط MSISDN واللغة التي يرسلها العميل في عنوان قبول اللغة والطابع الزمني العالي الدقة وتشفيرها عبر AES باستخدام مفتاح secret. يجب أن يتطابق الطابع الزمني مع الوقت الذي تنتهي فيه صلاحية معرّف CPID. الناتج المشفر هو Base64. بالإضافة إلى ذلك، عند استخدام معرّف CPID في عنوان URL، يجب أن يكون بترميز عنوان URL للتعامل مع الأحرف الخاصة (/+=) المستخدمة في Base64. وعلى وجه الخصوص، عندما توجّه "هيئة حماية البيانات" (DAF) "هيئة حماية البيانات" أو عندما تطلب "هيئة حماية البيانات" واجهة برمجة التطبيقات لمشاركة خطة بيانات الجوّال، يجب أن يكون معرّف CPID بترميز عنوان URL. من ميزات إنشاء معرّفات المعلِنين (CPID) باستخدام هذا المنهج أنّ نقطة نهاية معرّف المعلِنين (DPA) ونقطة معرّف المعلِنين (CPID) لا تحتاج إلى أن تكون قاعدة بيانات تتضمّن معرّفات معرّفات المعلِنين (CPIDs) ومعرّفات MSISDN صالحة.

واستنادًا إلى حالة عوامل التشغيل المعيّنة، قد لا يكون من المفيد تنفيذ نقطة نهاية CPID. يتمثّل تحدي معيّن واجهه المستخدمون كثيرًا في الوصول إلى MSISDN عند نقطة نهاية CPID. يسعدنا مشاركة الدروس حول إتاحة الدروس المستفادة. يُرجى التواصل معنا في حال واجهتك أي صعوبات.

متطلبات الأمان

على المشغّل اتخاذ جميع الاحتياطات اللازمة لحماية المعلومات الخاصة بالمشتركين. على وجه التحديد، للحد من تعرض أرقام هواتف المشتركين، يجب أن تكون نقطة نهاية CPID داخل محيط الأمان. بالإضافة إلى ذلك، في الحالات التي يستخدم فيها عامل التشغيل DPI، يجب أن يُشغّل عامل التشغيل MSSDN قبل إدخاله في طلب HTTP. إذا لم تكن نقطة نهاية CPID محيطًا بالأمان (على سبيل المثال، عند نشر نقطة نهاية CPID على سحابة إلكترونية عامة)، يجب ألا ينقل عامل التشغيل "MSISDN" عبر شبكة الإنترنت العامة. يمكن لعامل التشغيل إنشاء شبكة افتراضية خاصة بين DPI ونقطة نهاية CPID (انظر الشكل 1) أو تشفير MSISDN قبل إدخاله في الرأس. تفترض الطريقة الأخيرة أن نقطة نهاية CPID يمكنها فك تشفير العنوان الذي تم إدخاله لاسترداد رقم MSISDN قبل إنشاء معرّف CPID. بالإضافة إلى ذلك، فإنّ عامل التشغيل SHALL يحمي المفتاح السري المُستخدَم لإنشاء رقم CPID وتدوير هذا المفتاح وفقًا لسياسات أمان المشغّل.

متطلبات مدى التوفّر والسعة

إذا لم يتمكّن العملاء من استرداد قيمة CPID، لن يتمكّنوا من الوصول إلى أي معلومات من واجهة برمجة التطبيقات لخطة بيانات الجوّال. لهذا السبب، يجب أن يتّخذ عامل التشغيل "الإجراءات" اللازمة لضمان توفّر نقطة نهاية CPID. وتشمل هذه التدابير توفُّر مثيلات متعددة من نقاط نهاية CPID ووظائف DPI، فضلاً عن تكرار البيانات في كل من الموقع الجغرافي والشبكة والشبكة للدالتَين معًا وضمان أن تكون موارد النظام والسعة كافية. بالإضافة إلى ذلك، يجب أن تتوفّر لدى نقطة نهاية CPID بالإضافة إلى دالة DPI التي تُدخِل العنوان سعة كافية للتعامل مع حمل كل برامج Google التي تطلب أرقام CPID. يمكن أن تستخدم نقطة نهاية CPID قيمًا أكبر في الحقل ttlSeconds لتقليل فترة تكرار إنشاء أرقام CPID. وتنصح Google باستخدام قيمة مدة البقاء (TTL) تبلغ 30 يومًا.

ملاحظات

---

1. يُعدّ VIDEO_OFLINE PMTC صالحًا للاستخدام في وضع عدم الاتصال فقط (على سبيل المثال، جودة بث QoE للبث المباشر بشكل غير صحيح). وهي مستقلة عن نافذة FlexTime.↩