استخدام إشعارات واجهة برمجة تطبيقات Chrome Management Telemetry API

هذه المقالة مخصَّصة للمشرفين أو الشركاء الخارجيين الذين يستخدمون Chrome Management Telemetry API.

بصفتك مشرفًا في Chrome، يمكنك استخدام Chrome Telemetry API لمراقبة تشغيل أجهزة ChromeOS وسلامتها، ما يساعدك في تحليل الأسباب الأساسية وتحديد المشاكل وحلّها.

يمكنك باستخدام إشعارات واجهة برمجة التطبيقات Telemetry API في Chrome الاشتراك في إشعارات أحداث Telemetry API وتلقّيها باستخدام Google Cloud Pub/Sub.

لمزيد من التفاصيل، يُرجى الاطّلاع على Chrome Management Telemetry API.

Google Cloud Pub/Sub

يمكنك باستخدام Google Cloud Pub/Sub إنشاء نظام يضم منتجي ومستهلكي الأحداث، يُسمى ذلك بالناشرين والمشتركين. يبث هذا النظام الإحصاءات ومسارات تكامل البيانات لتلقّي البيانات وتوزيعها.

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

قبل البدء

قبل أن تتمكن من ربط إشعارات واجهة برمجة التطبيقات Telemetry API في Chrome Management بخدمة Google Cloud Pub/Sub، يُرجى التأكُّد مما يلي:

أن يكون لديك إذن وصول المشرف المتميّز إلى "وحدة تحكُّم المشرف في Google". يتطلب هذا حسابًا مُدارًا من Google ونطاقًا مثبَت ملكيته. لمزيد من التفاصيل، يُرجى الاطّلاع على الانضمام إلى مؤسسة Chrome المُدارة.
تم تسجيل أجهزة ChromeOS في النطاق المستخدَم للوصول إلى "وحدة تحكّم المشرف". لمزيد من التفاصيل، يُرجى الاطّلاع على تسجيل أجهزة ChromeOS.
أن يكون لديك مشروع على Google Cloud من أجل تفعيل خدمة Pub/Sub للإشعارات.

الخطوة 1: تفعيل إشعارات Chrome Management Telemetry

سجِّل الدخول إلى وحدة تحكم المشرف في Google.
يُرجى تسجيل الدخول باستخدام حساب المشرف (لا ينتهي بالنطاق gmail.com@).
في "وحدة تحكّم المشرف"، انقر على رمز القائمة الأجهزةChromeالإعداداتإعدادات الجهاز.
لتطبيق الإعداد على جميع المستخدمين والمتصفحات المُسجّلة، يُرجى الإبقاء على اختيار الوحدة التنظيمية العليا. بخلاف ذلك، يمكنك اختياروحدة تنظيمية فرعية.
انتقِل إلى إعداد التقارير المتعلّقة بالجهاز والمستخدم.
انقر على التقرير عن قياس الأجهزة عن بُعد.
اختَر تفعيل إعداد تقارير عن كل عمليات القياس عن بعد.
انقر على حفظ.

عند تفعيل إعداد تقارير القياس عن بُعد، يمكنك إنشاء اشتراك في أنواع مختلفة من الأحداث التي تتم على أجهزة ChromeOS في مؤسستك. بعد ذلك، يتم إرسال إشعارات هذه الأحداث إلى موضوع Pub/Sub (النشر/الاشتراك) الذي تم إعداده.

الخطوة 2: إنشاء موضوع النشر/الاشتراك في مشروع Google Cloud

لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة دمج Google Cloud Pub/Sub مع "إدارة السحابة الإلكترونية في متصفِّح Chrome".

سجِّل الدخول إلى Google Cloud Platform.
في قسم النشر/الاشتراك، انتقِل إلى صفحة المواضيع.
اختَر موضوعًا متاحًا أو انقر على إنشاء موضوع.
أدخِل رقم تعريف الموضوع وانقر على إنشاء موضوع.
اختَر الموضوع الذي أنشأته لتلقّي الأحداث من Chrome.
ضمن الأذونات، انقر على إضافة عضو.
ضمن New principals (العناصر الرئيسية الجديدة)، أدخِل cloud-pub-sub-publisher@chrome-reporting.iam.gserviceaccount.com.
هذا هو الحساب الذي يستخدمه خادم Google لإجراء استدعاءات إلى Publish API لموضوع Pub/Sub. يجب أن يمنح الموضوع إذن النشر لهذا الحساب.
من الدور، اختَر ناشر Pub/Sub.
انقر على حفظ.
انسخ المسار الكامل لموضوعك واحفظه من أجل الخطوات التالية في "وحدة تحكّم المشرف".

الخطوة 3: تسجيل موضوع Pub/Sub وإنشاء عمليات ضبط الإشعارات

لإنشاء عمليات ضبط الإشعارات، يجب استدعاء Chrome Management Telemetry API. تجد في الروابط التالية أي معلومات إضافية تحتاج إليها.

للتعرّف على طريقة الوصول إلى Chrome Management Telemetry API، يمكنك الاطّلاع على هذا الدليل العام.
للاطّلاع على كيفية إنشاء إعدادات الإشعارات، يمكنك الانتقال إلى هذه الصفحة. يمكنك استدعاء واجهة برمجة التطبيقات Telemetry notifications API وإنشاء عمليات ضبط الإشعارات من خلال إرسال طلب POST.
- في النص الأساسي، استبدِل google_cloud_pubsub_topic بموضوعك.
  على سبيل المثال، كي تضبط إشعارات الأحداث لإشعارات USB التي تمت إضافتها وإزالتها، يمكنك ضبط:

{

"google_cloud_pubsub_topic": "projects/your-project/topics/your-topic",

"filter": {

"telemetry_event_notification_filter": {

"event_types": [

"USB_ADDED",

"USB_REMOVED"

]

}

الخطوة 4: بدء تلقّي إشعارات واجهة برمجة التطبيقات Chrome Management Telemetry API

يمكنك تلقّي الإشعارات بالطُرق التالية:

هل كان ذلك مفيدًا؟

كيف يمكننا تحسينها؟