ট্রিগার পুশ বিজ্ঞপ্তি

বিজ্ঞপ্তি প্রকার

বার্তা যোগ করুন এবং অবহিত করুন

পটভূমি

একজন ব্যবহারকারী একটি পাস যোগ করার পরে আপনি তাদের পাস সম্পর্কিত একটি বার্তা পাঠাতে এবং তারা এটি সম্পর্কে অবহিত করা নিশ্চিত করতে চাইতে পারেন। TEXT_AND_NOTIFY এর সমান একটি message_type সহ অ্যাড মেসেজ API অনুরোধটি ব্যবহার করে নিম্নলিখিতটি ঘটে:

1. একটি " বার্তা " আইটেম "পাসের পিছনে" (ওরফে বিবরণ টেমপ্লেট ) যোগ করা হয় এবং পাস সংরক্ষিত ব্যবহারকারীদের কাছে একটি পুশ বিজ্ঞপ্তি পাঠানো হয়।
2. ব্যবহারকারী একবার বিজ্ঞপ্তিতে ট্যাপ করলে এটি পাসের সামনে Google Wallet খুলবে (ওরফে কার্ড ভিউ) এবং ব্যবহারকারী একটি "মেসেজ দেখুন" বোতাম সহ স্ক্রিনের শীর্ষে একটি কলআউট দেখতে পাবেন।
3. কলআউটে ক্লিক করা ব্যবহারকারীদের পাসের পিছনে নিয়ে যাবে, যেখানে নতুন অপঠিত বার্তাগুলি হাইলাইট করা হবে।

ব্যবহারকারীদের বিজ্ঞপ্তি সহ বার্তা পাঠানোর সময় কিছু বিবেচনা

• বার্তাগুলির সাথে সম্পর্কিত পুশ বিজ্ঞপ্তিগুলি পেতে ব্যবহারকারীদের অবশ্যই তাদের পাসগুলির জন্য বিজ্ঞপ্তিগুলি সক্ষম করতে হবে৷
• বার্তাগুলিতে আপনার ওয়েবসাইট বা অ্যাপের URI থাকতে পারে। হাইপারলিঙ্ক অবশ্যই পাস সম্পর্কিত একটি ওয়েবসাইট বা অ্যাপ হতে হবে। পাসের সাথে সম্পর্কিত নয় এমন লিঙ্কগুলিতে ব্যবহারকারীদের পাঠানোর জন্য এটি গ্রহণযোগ্য ব্যবহারের নীতির লঙ্ঘন।
• আপনি সর্বোচ্চ 3টি বার্তা পাঠাতে পারেন যা 24 ঘন্টা সময়ের মধ্যে একটি পুশ বিজ্ঞপ্তি ট্রিগার করে। Google আপনার পুশ নোটিফিকেশন ডেলিভারি কোটা থ্রোটল করতে পারে যদি মনে হয় আপনি আপনার ব্যবহারকারীদের স্প্যাম করছেন।
• ব্যবহারকারীরা তাদের লক স্ক্রিনে যে পুশ বিজ্ঞপ্তি দেখেন তা Google Wallet দ্বারা নিয়ন্ত্রিত হয়৷
• আপনি নিয়মিত ক্লাস বা অবজেক্ট এন্ডপয়েন্ট ব্যবহার করে বার্তা ডেটা সম্পাদনা বা অপসারণ করতে আপডেট বা প্যাচ পদ্ধতি ব্যবহার করতে পারেন।

ইন্টিগ্রেশন পদক্ষেপ

আপনি যখন AddMessage API ব্যবহার করে যুক্ত করা একটি নতুন ইস্যুকারী বার্তা সম্পর্কে ব্যবহারকারীদেরকে অবহিত করতে চান, তখন আপনাকে AddMessageRequest আপডেট করতে হবে যাতে আপনার নতুন পাঠ্য ধারণ করা বার্তাটিতে TEXT এর পরিবর্তে MessageType 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"
    },
  …

বার্তা যোগ করার এবং পাস ক্লাসের জন্য বিজ্ঞপ্তি দেওয়ার উদাহরণ প্রতিক্রিয়া

  // 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_AND_NOTIFY " এর পরিবর্তে " TEXT " ব্যবহার করে সেট করা যেতে পারে যেমন ইন্টিগ্রেশন ধাপে আলোচনা করা হয়েছে৷

ক্ষেত্র আপডেট করুন এবং অবহিত করুন

পটভূমি

একজন ব্যবহারকারী একটি পাস যোগ করার পরে আপনি যখন নির্দিষ্ট ক্ষেত্র আপডেট করেন তখন আপনি একটি পুশ বিজ্ঞপ্তি ট্রিগার করতে চাইতে পারেন। বিজ্ঞপ্তিটি ব্যবহারকারীর লক স্ক্রিনে উপস্থিত হবে এবং তাদের জানিয়ে দেবে যে তাদের পাসে একটি আপডেট রয়েছে। এই বিজ্ঞপ্তিটি শুধুমাত্র UPDATE এবং PATCH API পদ্ধতিগুলি ব্যবহার করে নীচে সংজ্ঞায়িত ক্ষেত্রগুলির একটি নির্দিষ্ট উপসেটের জন্য ট্রিগার করবে৷ একবার পাস আপডেট করার জন্য একটি API কল করা হলে নিম্নলিখিতগুলি ঘটে:

1. একটি পুশ বিজ্ঞপ্তি ট্রিগার করা হয় এবং ব্যবহারকারীর লক স্ক্রিনে প্রদর্শিত হয়, তাদের একটি পাস আপডেট সম্পর্কে অবহিত করে।
2. ব্যবহারকারী একবার বিজ্ঞপ্তিটি ট্যাপ করলে এটি পাসের সামনে Google Wallet খুলবে (ওরফে কার্ড ভিউ) এবং ব্যবহারকারী একটি "পর্যালোচনা আপডেট" বোতাম সহ স্ক্রিনের শীর্ষে একটি কলআউট দেখতে পাবেন।
3. বোতামটি ক্লিক করা ব্যবহারকারীকে একটি স্ক্রিনে নিয়ে আসে যেখানে তারা আপডেটের মাধ্যমে পরিবর্তিত ক্ষেত্রগুলি দেখতে পাবে।

ফিল্ড আপডেট বিজ্ঞপ্তি পাঠানোর সময় কিছু বিবেচ্য বিষয়

• আপডেটের সাথে সম্পর্কিত পুশ বিজ্ঞপ্তিগুলি পেতে ব্যবহারকারীদের অবশ্যই তাদের পাসগুলির জন্য বিজ্ঞপ্তিগুলি সক্রিয় থাকতে হবে।
• আপনি সর্বোচ্চ 3টি আপডেট পাঠাতে পারেন যা 24 ঘন্টা সময়ের মধ্যে একটি পুশ বিজ্ঞপ্তি ট্রিগার করে৷ Google আপনার পুশ নোটিফিকেশন ডেলিভারি কোটা থ্রোটল করতে পারে যদি মনে হয় আপনি আপনার ব্যবহারকারীদের স্প্যাম করছেন।
• ব্যবহারকারীরা তাদের লক স্ক্রিনে যে পুশ বিজ্ঞপ্তি দেখে তা Google Wallet দ্বারা নিয়ন্ত্রিত হয়৷
• notifyPreference ক্ষেত্রটি একটি ক্ষণস্থায়ী ক্ষেত্র যা শুধুমাত্র এই অনুরোধের উপরই থাকে। ভবিষ্যতের অনুরোধের জন্য যখন আপনি একটি বিজ্ঞপ্তি ট্রিগার করতে চান, আপনাকে ক্লাস বা বস্তুর অনুরোধে এই ক্ষেত্রটি পুনরায় সেট করতে হবে।

ইন্টিগ্রেশন পদক্ষেপ

এই বিজ্ঞপ্তিগুলি ট্রিগার করার জন্য, আপনাকে বিদ্যমান আপডেট বা প্যাচ কলগুলি ব্যবহার করতে হবে এবং notifyPreference নির্দিষ্ট করতে হবে৷ একটি ক্লাস বা অবজেক্টে একটি ক্ষেত্র আপডেট করার সময়, আপনি বিজ্ঞপ্তিটি ট্রিগার করার জন্য ক্লাস বা অবজেক্টের অনুরোধে একটি নতুন ক্ষেত্র, notifyPreference যোগ করতে পারেন।

ক্লাসে আপডেট এবং বিজ্ঞপ্তি দেওয়ার জন্য JSON অনুরোধের উদাহরণ

    …
    "dateTime":
        {
            "kind": "walletobjects#eventDateTime",
            "doorsOpen": "2024-09-23T19:20:50.00"
        },
    "multipleDevicesAndHoldersAllowedStatus": "multipleHolders",
    "notifyPreference": "notifyOnUpdate",
    …
  

notifyOnUpdate এ notifyPreference সেট করা একটি বিজ্ঞপ্তি ট্রিগার করবে, যদি আপডেট করা ক্ষেত্রটি বর্তমানে সমর্থিত হয়।

সমর্থিত ক্ষেত্র

লয়ালটি ক্লাস

• পুরস্কারের স্তর
• মাধ্যমিক পুরস্কারের স্তর
• প্রোগ্রামের নাম

LoyaltyObject

• loyaltyPoints.balance
• secondaryLoyaltyPoints.balance