يمكنك إرسال رسائل واستلامها إلى المستخدمين النهائيين من خلال: chrome.gcm. لأنها تستند إلى المراسلة عبر السحابة الإلكترونية من Firebase (FCM)، فهي تعتمد على خدمة خارجية تحتاج إليها لإعداده. ترشدك طريقة التنفيذ هذه إلى جميع الخطوات اللازمة للحصول على العمل في الإضافة.
على الرغم من أنّ chrome.gcm لا يزال متاحًا، تم إنشاؤه قبل أكثر من عشر سنوات.
معيار الدفع. بشكلٍ عام، من أفضل الممارسات دائمًا استخدام الويب
القياسية، بدلاً من واجهة برمجة التطبيقات الخاصة بالإضافة. ما لم تكن لديك حاجة محدّدة
لاستخدام chrome.gcm، نقترح استخدام Push.
المتطلبات الأساسية
لاستخدام chrome.gcm، يجب إعداد Firebase.
الحساب.
بعد إنشاء حساب، ستحتاج إلى فتح Firebase وحدة التحكّم واختَر مشروعًا حاليًا لاستخدامه أو إنشاء مشروع جديد للإضافة.
تابع إلى صفحة الإعدادات لخدمة "المراسلة عبر السحابة الإلكترونية".
إذا كان لديك حساب حالي للمراسلة عبر السحابة الإلكترونية في هذا المشروع، عليك انسخ معرّف المرسل الرقمي المدرج.
في حال عدم تفعيل ميزة المراسلة على السحابة الإلكترونية، يجب تفعيل Firebase Cloud Messaging API للمشروع داخل Google Cloud. في ما يلي يمكنك معرفة موضع الرابط مباشرةً إلى هذه الصفحة في منصة Firebase الإعدادات.
بعد تفعيل الميزة، يمكنك العودة إلى صفحة إعدادات السحابة الإلكترونية مراسلة ونسخ معرّف المُرسِل.
ضبط chrome.gcm
الآن بعد أن حصلت على معرّف المرسل من Firebase، يمكنك تهيئة إضافتك
للاستماع إلى الرسائل. في البداية، يجب التأكد من إضافة gcm.
إذن بالوصول إلى manifest.json في إضافتك
{
"manifest_version": 3,
...
"permissions": ["gcm"]
يمكنك الآن الوصول إلى واجهة برمجة تطبيقات chrome.gcm. يمكنك التسجيل للاستماع إلى الإشعارات
الرسائل من خلال الاتصال بالرقم chrome.gcm.register
الاستماع إلى الرسائل
بعد أن تسجّل الإضافة معرّف المُرسِل، يجب إضافة رمز للتعامل مع الواردة.
Firebase بدون Firebase
على الرغم من مرور chrome.gcm دائمًا بمنصة Firebase، يمكن ضبط Firebase على
يعمل كوكيل لموردي رسائل الدفع الخارجيين. عادةً ما يستخدم البائعون
إدراج إضافات Chrome بشكل صريح، ولكن أي مورّد يدعم
من المفترض أن تعمل الإشعارات الفورية القديمة من Firebase. إذا كان المزود لديك قوائم
لإتاحة الإشعارات الفورية القديمة من Firebase، جرّبها. إذا واجهت
المشكلات، فينبغي أن يكون مزودو الدعم قادرين على توضيح أي قيود
في مكانه الصحيح.
على القنوات والمواضيع
يستخدم chrome.gcm واجهات برمجة تطبيقات المراسلة القديمة في Firebase. هذا مهم
لأنّ واجهة برمجة التطبيقات القديمة لا تتيح ميزة قنوات الرسائل كل رسالة
الدفع إلى كل عميل. إذا كانت إضافة المستخدم مهتمة فقط بـ
مجموعة فرعية من الرسائل، ستحتاج إلى إجراء فلترة بنفسك.
بينما يبدأ Firebase كحساب مجاني، سيتم تحصيل الرسوم منك بعد الانتقال إلى حد استخدام معين. إذا كنت تخطط لإرسال رسائل إلى مجموعات محددة، فقد ينتج عن الفلترة من جهة العميل تكلفة تفوق ما هو مضمونه. يمكنك لتفادي ذلك من خلال إنشاء مشاريع متعددة لتكرار قنوات فردية (مشروع واحد ومعرّف مرسِل واحد لكل قناة) يمكن لأي إضافة محددة التسجيل لمعرّفات مرسلين متعددة، بما يصل إلى 100 معرّف.
يمكنك أيضًا إذا أردت الحصول على الدعم من خلال القنوات أو استخدام الإشعارات الفورية. بدون الانتقال إلى Firebase، يمكنك استخدام Push API.