أنواع الإشعارات
إضافة رسالة وإرسال إشعار
الخلفية
بعد أن يضيف مستخدم بطاقة، ننصحك بإرسال رسالة مرتبطة
بالبطاقة والتأكّد من إعلامه بها. عند استخدام طلب Add Message API
مع message_type يساوي
TEXT_AND_NOTIFY، يحدث ما يلي:
- تتم إضافة عنصر "رسالة" إلى "البطاقة الخلفية" (المعروف أيضًا باسم نموذج التفاصيل)، ويتم إرسال إشعار فوري إلى المستخدمين عند حفظ البطاقة.
- وعندما ينقر المستخدم على الإشعار، يتم فتح "محفظة Google" في مقدّمة البطاقة (يُعرف أيضًا باسم "عرض البطاقة")، وسيرى المستخدم وسيلة شرح في أعلى الشاشة مع الزر "عرض الرسالة".
- يؤدي النقر على وسيلة الشرح إلى نقل المستخدمين إلى الجهة الخلفية من البطاقة، حيث يتم تمييز الرسائل الجديدة غير المقروءة.
بعض الاعتبارات عند إرسال الرسائل التي تتضمن إشعارات إلى المستخدمين
- يجب أن يفعّل المستخدمون الإشعارات لبطاقاتهم لتلقّي الإشعارات الفورية المتعلّقة بالرسائل.
- قد تحتوي الرسائل على معرّفات موارد منتظمة (URI) لموقعك الإلكتروني أو تطبيقك. يجب أن تكون الروابط التشعّبية موقعًا إلكترونيًا أو تطبيقًا مرتبطًا بالبطاقة. يشكّل توجيه المستخدمين إلى روابط غير مرتبطة بالبطاقة انتهاكًا لسياسة الاستخدام المقبول.
- يمكنك إرسال 3 رسائل كحدّ أقصى تؤدي إلى ظهور إشعار فوري خلال 24 ساعة. قد تُقيِّد Google حصة تسليم الإشعارات الفورية إذا رأت أنّك ترسِل محتوى غير مرغوب فيه إلى المستخدمين.
- وتتحكّم "محفظة Google" في الإشعارات الفورية التي تظهر للمستخدمين على شاشة القفل.
- يمكنك استخدام الإجراءين UPDATE أو PATCH لتعديل بيانات الرسالة أو إزالتها باستخدام الفئة العادية أو نقطة نهاية العنصر.
خطوات الدمج
عندما تريد إرسال إشعارات إلى المستخدمين بشأن رسالة جهة إصدار جديدة تمت إضافتها باستخدام واجهة برمجة التطبيقات AddMessage API، عليك تعديل AddMessageRequest لكي تحتوي الرسالة التي تتضمّن النص الجديد على MessageType TEXT_AND_NOTIFY بدلاً من TEXT_AND_NOTIFY.
مثال على طلب JSON لإضافة رسالة وإرسال إشعار في فئة البطاقات
…
"id": ISSUER_ID.CLASS_ID",
"message":
{
"header":"My Class message header",
"body": "My Class message body with a <a href="https://wallet.google">Hyperlink<\a>",
"id": "message_id",
"message_type": "TEXT_AND_NOTIFY"
},
…
مثال على طلب JSON لإضافة رسالة وإشعار في عنصر بطاقات
…
"id": OBJECT_ID",
"classId": "ISSUER_ID.CLASS_ID",
"message":
{
"header":"My Object message header",
"body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>",
"id": "message_id",
"message_type": "TEXT_AND_NOTIFY"
},
…
مثال على Response (الردّ) لإضافة رسالة وإرسال إشعار لفئة البطاقة.
// The updated resource
…
{
"kind": "walletobjects#walletObjectMessage",
"header": "My Object message header",
"body": "My Object message body with a <a href="http://play.google.com/store/apps/details?id=com.google.android.apps.maps">Hyperlink<\a>",
"id": "message_id",
"messageType": "textAndNotify"
},
…
معالجة الاستثناء
وستؤدي أي محاولات للإشعار أكثر من 3 مرات إلى ظهور الردّ QuotaExceededException . يمكن ضبط أي تعديلات إضافية على البطاقة باستخدام "TEXT" بدلاً من "TEXT_AND_NOTIFY" كما هو موضَّح في خطوات الدمج.