تشغيل الإشعارات الفورية

أنواع الإشعارات

إضافة رسالة وإشعار

الخلفية

بعد أن يضيف المستخدم بطاقة، يمكنك إرسال رسالة إليه بشأن ناجحًا والتأكد من إعلامه بذلك. باستخدام Add Message API (إضافة واجهة برمجة تطبيقات الرسائل) طلب بقيمة message_type يساوي TEXT_AND_NOTIFY سيحدث ما يلي:

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

بعض الاعتبارات عند إرسال الرسائل مع الإشعارات إلى المستخدمين

  • لتلقّي هذه الإشعارات، يجب أن تكون الإشعارات مفعَّلة لبطاقاتهم. الإشعارات الفورية ذات الصلة بالرسائل.
  • قد تحتوي الرسائل على معرّفات موارد منتظمة (URI) لموقعك الإلكتروني أو تطبيقك. يجب أن تكون الروابط التشعبية الموقع الإلكتروني أو التطبيق المرتبط بالبطاقة. ويُعد ذلك انتهاكًا سياسة الاستخدام المقبول إرسال المستخدمين إلى روابط غير مرتبطة بالبطاقة
  • يمكنك إرسال 3 رسائل كحد أقصى تؤدي إلى ظهور إشعار فوري في كل 24 ساعة. قد توقف Google حصة تسليم الإشعارات الفورية في حال يرى أنك ترسل رسائل غير مرغوب فيها إلى المستخدمين.
  • تتحكّم Google في الإشعارات الفورية التي تظهر للمستخدمين على شاشة القفل. محفظة Google.
  • يمكنك استخدام الخيار تحديث. أو تصحيح طرق لتعديل بيانات الرسائل أو إزالتها باستخدام الفئة أو الكائن العادي النهائية.

خطوات الدمج

عندما تريد إشعار المستخدمين بشأن رسالة جهة إصدار جديدة تمت إضافتها باستخدام واجهة برمجة تطبيقات AddMessage، ستحتاج إلى تعديل عنصر AddMessageRequest. لكي تظهر الرسالة الذي يحتوي على نص جديد يتضمّن MessageType TEXT_AND_NOTIFY بدلاً من TEXT.

مثال على طلب بتنسيق 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"
    },
  …

مثال على الرد لإضافة رسالة وإشعار بشأن فئة "بطاقة"

  // 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" كما هو موضَّح في مقالة دمج الخطوات: