تفعيل الإشعارات الفورية لإدارة الخدمات الجوّالة للمؤسسات (EMM)

يفترض هذا الدليل أن لديك مسبقًا وكالة ESA تم إنشاؤها يدويًا ويعرض لك كيفية إعداده للاستخدام مع الإشعارات الفورية لإدارة الخدمات الجوّالة للمؤسسات (EMM). اكتملت المهام مالك وكالة الفضاء الأوروبية (أنت، بصفتك موفر حلول إدارة الخدمات الجوّالة للمؤسسات (EMM) أو عميلك) باستخدام وحدة التحكم في واجهة Google API:

1. تفعيل إمكانية الوصول إلى واجهة برمجة التطبيقات Google Cloud Pub/Sub في وحدة تحكُّم واجهة Google API على السحابة الإلكترونية.

2. امنح أذونات "المحرِّر" إلى وكالة ESA.

3- عليك إعداد مشروع لتلقّي إشعارات إدارة الخدمات الجوّالة للمؤسسات (EMM).

4. إرسال إشعار تجريبي لإدارة الخدمات الجوّالة للمؤسسات (EMM)

5- الاشتراك في الموضوع

تم توضيح هذه الخطوات بشكل كامل في الأقسام التالية.

1. تفعيل إمكانية الوصول إلى واجهة برمجة التطبيقات Cloud Pub/Sub لمشروع ما

لتفعيل Cloud Pub/Sub API لمشروعك، يُرجى اتّباع الخطوات التالية:

  1. في وحدة تحكّم واجهة برمجة التطبيقات، افتح مكتبة واجهة برمجة التطبيقات. اختيار المشروع (أو قم بإنشاء مشروع جديد، إذا لزم الأمر). تسرد مكتبة واجهة برمجة التطبيقات كل واجهات برمجة التطبيقات المتاحة، مجمّعة حسب مجموعة المنتجات وشعبيتها.
  2. ضمن Google Cloud APIs، ابحث عن Cloud Pub/Sub API. (إذا لم تكن مرئية في القائمة، فاستخدم البحث للعثور عليها).
  3. اختَر Cloud Pub/Sub API، ثم انقر على تفعيل.

بعد تمكين إحدى واجهات برمجة التطبيقات، من واجهات برمجة التطبيقات الخدمات، انقر على لوحة البيانات لعرض قائمة بجميع واجهات برمجة التطبيقات التي تم تفعيلها. قبل السحابة يمكن استخدام واجهة برمجة تطبيقات Pub/Sub لإرسال الرسائل إلى العميل، ويجب منح "المحرّر" إلى حساب خدمة العميل هذا (ESA).

2. منح أذونات المحرر إلى وكالة الفضاء الأوروبية

من وحدة تحكم واجهة برمجة التطبيقات، امنح الأذونات اللازمة:

  1. من واجهات برمجة التطبيقات انقر على بيانات الاعتماد "الخدمات". عليك راجع ESA الخاصة بعملائك والواردة ضمن مفاتيح حساب الخدمة.
  2. انقر على إدارة حسابات الخدمة لفتح جميع حسابات الخدمة. المرتبطة بالمشروع.
  3. من القائمة، حدد حساب ESA المناسب، ثم انقر الأذونات:
  4. في الحقل إضافة أعضاء:
    • أدخِل عنوان البريد الإلكتروني المرتبط بوكالة الفضاء الأوروبية (ESA).
    • من المُحدِّد المنسدل، اختر محرر (بجوار هذا الحقل).
  5. انقر على إضافة لحفظ "الأذونات".

3- إعداد مشروع لتلقّي إشعارات إدارة الخدمات الجوّالة للمؤسسات (EMM)

عند تفعيل واجهة برمجة التطبيقات Cloud Pub/Sub وتهيئة وكالة الفضاء الأوروبية (ESA) باستخدام "المحرّر" يمكنك ضبط مشروع لتلقّي إشعارات إدارة الخدمات الجوّالة للمؤسسات (EMM) مفصل في مجموعة الإشعارات الفورية لإدارة الخدمات الجوّالة للمؤسسات (EMM) باختصار، تتضمن عملية الإعداد تهيئة نقطة نهاية خادم HTTP لإرسال الإشعارات إلى المشتركين.

يتم تسليم إشعارات إدارة الخدمات الجوّالة للمؤسسات (EMM) في صيغة protobufs (المخازن المؤقتة للبروتوكولات، وهي تنسيق بسيط لتسلسل البيانات المنظَّمة) مجمعة رسائل مصفوفة بايت بترميز بايت64 داخل حزم JSON. في التعليمات البرمجية، يجب تحليل JSON هذا وفك ترميز محتوى المخزن المؤقت للبروتوكول. إليك مثال على هذا النظام من نموذج أوّلي بترميز base64 متوافق مع عنوان URL، وذلك لـ NewPermissionsEvent الإشعار:


CglDMTIzNDU2NzgQgM-C6sMqOooBChdhcHA6Y29tLmZha2VhcHAuZXhhbXBsZRIpYW5kcm9pZ
C5wZXJtaXNzaW9uLldSSVRFX0VYVEVSTkFMX1NUT1JBR0UaKGFuZHJvaWQucGVybWlzc2lvbi5SRUF
EX0VYVEVSTkFMX1NUT1JBR0UaGmFuZHJvaWQucGVybWlzc2lvbi5WSUJSQVRF

يتم فك الترميز إلى:


{
 enterprise_id: "C12345678"
 event_notification_sent_timestamp_millis: 1461316528000 # 1.33Ti;
    [as milliseconds]: 2016-04-22 10:15:28 +0100
 new_permissions_event: {
   product_id: "app:com.fakeapp.example"
   requested_permissions: [ "android.permission.WRITE_EXTERNAL_STORAGE" ]
   approved_permissions : [ "android.permission.READ_EXTERNAL_STORAGE",
    "android.permission.VIBRATE" ]
  }
}

لفك ترميز إشعارات إدارة الخدمات الجوّالة للمؤسسات (EMM) بتنسيق أولي، يمكنك استخدام هناك ملف واحد (emm_pubsub.proto) موجود في google/play-work على GitHub. عند تفعيل أنواع الإشعارات الجديدة تمت إضافتها، يتم توسيع هذا الملف بالنوع الجديد ويتم تحديث نموذج التعليمة البرمجية. يجب أن تكون هذه التغييرات متوافقة مع الأنظمة القديمة، ولكن احرص على أن تتوافق الرمز البرمجي مع برفق مع تلقي إشعارات من أنواع غير معروفة بالإضافة إلى تلك مدرجة في ملف .proto.

4. إرسال إشعار تجريبي لإدارة الخدمات الجوّالة للمؤسسات (EMM)

يتيح لك إرسال إشعار تجريبي تأكيد أنّك نجحت إعداد نظامك لتلقّي إشعارات إدارة الخدمات الجوّالة للمؤسسات (EMM) من Google Play أيضًا التعرف على اسم الموضوع (يُستخدم اسم الموضوع نفسه لتقديم جميع إشعارات إدارة الخدمات الجوّالة للمؤسسات (EMM) في Google Play).

باستخدام واجهة برمجة التطبيقات Play EMM API، يمكنك طلب طريقة sendTestPushNotification في مرجع المؤسسات.

يؤدي استدعاء هذه العملية إلى إرسال إشعار تجريبي لإدارة الخدمات الجوّالة للمؤسسات (EMM). في حال إدارة الخدمات الجوّالة للمؤسسات (EMM) بشكل صحيح، تعرض واجهة برمجة التطبيقات ما يلي:

    {
        topic_name: "/projects/project-name/topics/play-work-012345",
        message_id: "128976912439"
    }

5- الاشتراك في الموضوع

باستخدام نموذج الرمز المقدّم في تشغيل رمز اختبار الناشر (في قسم إعداد إرسال رسالة إلكترونية لإدارة الخدمات الجوّالة للمؤسسات (EMM) الإشعارات)، أو الاشتراك في الموضوع المحدد. ينبغي أن تتلقى إشعار إدارة الخدمات الجوّالة للمؤسسات (EMM) التجريبي، إلى جانب أي إشعارات فعلية تم إنشاؤه منذ بدء عملية التهيئة.