রিয়েল-টাইম ডেভেলপার বিজ্ঞপ্তি সংক্রান্ত রেফারেন্স গাইড

এই ডকুমেন্টে Google Play থেকে আপনি যেসব রিয়েল-টাইম ডেভেলপার বিজ্ঞপ্তি পেতে পারেন, সেগুলির তালিকা ও বিবরণ দেওয়া আছে।

এনকোডিং

Cloud Pub/Sub টপিকে প্রতিটি প্রকাশনায় একটি base64-এনকোড করা ডেটা ফিল্ড থাকে।

{
  "message": {
    "attributes": {
      "key": "value"
    },
    "data": "eyAidmVyc2lvbiI6IHN0cmluZywgInBhY2thZ2VOYW1lIjogc3RyaW5nLCAiZXZlbnRUaW1lTWlsbGlzIjogbG9uZywgIm9uZVRpbWVQcm9kdWN0Tm90aWZpY2F0aW9uIjogT25lVGltZVByb2R1Y3ROb3RpZmljYXRpb24sICJzdWJzY3JpcHRpb25Ob3RpZmljYXRpb24iOiBTdWJzY3JpcHRpb25Ob3RpZmljYXRpb24sICJ0ZXN0Tm90aWZpY2F0aW9uIjogVGVzdE5vdGlmaWNhdGlvbiB9",
    "messageId": "136969346945"
  },
  "subscription": "projects/myproject/subscriptions/mysubscription"
}

base64-এনকোড করা ডেটা ফিল্ড ডিকোড করার পরে, DeveloperNotification-এ নিম্নলিখিত ফিল্ডগুলি থাকে:

{
  "version": string,
  "packageName": string,
  "eventTimeMillis": long,
  "oneTimeProductNotification": OneTimeProductNotification,
  "subscriptionNotification": SubscriptionNotification,
  "voidedPurchaseNotification": VoidedPurchaseNotification,
  "pendingRefundReviewNotification": PendingRefundReviewNotification,
  "testNotification": TestNotification
}

এইসব ফিল্ডের বিবরণ নিচের সারণীতে দেওয়া হল।

প্রপার্টির নাম মান বর্ণনা
ভার্সন স্ট্রিং এই বিজ্ঞপ্তির ভার্সন। প্রাথমিকভাবে, এটি "১.০"। এই ভার্সনটি অন্যান্য ভার্সন ফিল্ড থেকে আলাদা।
packageName স্ট্রিং এই বিজ্ঞপ্তি যে অ্যাপ্লিকেশনের সাথে সম্পর্কিত, সেটির প্যাকেজের নাম (যেমন, `com.some.thing`)।
eventTimeMillis দীর্ঘ ইভেন্ট ঘটার টাইমস্ট্যাম্প, Epoch থেকে মিলিসেকেন্ডে।
subscriptionNotification SubscriptionNotification

এই ফিল্ড থাকলে, এই বিজ্ঞপ্তি সাবস্ক্রিপশন সম্পর্কিত এবং এই ফিল্ডে সাবস্ক্রিপশন সম্পর্কিত অতিরিক্ত তথ্য থাকে।

মনে রাখবেন যে এই ফিল্ডটি pendingRefundReviewNotification, oneTimeProductNotification, voidedPurchaseNotification এবং testNotification-এর সাথে মিউচুয়ালি এক্সক্লুসিভ।

oneTimeProductNotification OneTimeProductNotification

এই ফিল্ড থাকলে, এই বিজ্ঞপ্তি এক-বার কেনাকাটার সাথে সম্পর্কিত এবং এই ফিল্ডে কেনাকাটা সম্পর্কিত অতিরিক্ত তথ্য থাকে।

মনে রাখবেন যে এই ফিল্ডটি pendingRefundReviewNotification, subscriptionNotification, voidedPurchaseNotification এবং testNotification-এর সাথে মিউচুয়ালি এক্সক্লুসিভ।

voidedPurchaseNotification VoidedPurchaseNotification

এই ফিল্ডটি থাকলে, এই বিজ্ঞপ্তিটি বাতিল করা কেনাকাটার সাথে সম্পর্কিত এবং এই ফিল্ডে বাতিল করা কেনাকাটার সাথে সম্পর্কিত অতিরিক্ত তথ্য রয়েছে।

মনে রাখবেন যে এই ফিল্ডটি pendingRefundReviewNotification, oneTimeProductNotification, subscriptionNotification এবং testNotification-এর সাথে পারস্পরিকভাবে এক্সক্লুসিভ।

pendingRefundReviewNotification PendingRefundReviewNotification

এই ফিল্ডটি থাকলে, এই বিজ্ঞপ্তিটি একটি চার্জব্যাক অনুরোধের সাথে সম্পর্কিত যার জন্য আপনি একটি রেজোলিউশন সাজেস্ট করতে পারেন। `ReviewRefund` API কল করে এই বিজ্ঞপ্তির উত্তর দিন।

মনে রাখবেন যে এই ফিল্ডটি subscriptionNotification, oneTimeProductNotification, voidedPurchaseNotification, এবং testNotification-এর সাথে পারস্পরিকভাবে এক্সক্লুসিভ।

testNotification TestNotification

এই ফিল্ডটি থাকলে, এই বিজ্ঞপ্তিটি একটি টেস্ট প্রকাশের সাথে সম্পর্কিত। এগুলি শুধুমাত্র Google Play Developer Console-এর মাধ্যমে পাঠানো হয়।

মনে রাখবেন যে এই ফিল্ডটি pendingRefundReviewNotification, oneTimeProductNotification, subscriptionNotification এবং voidedPurchaseNotification-এর সাথে পারস্পরিকভাবে এক্সক্লুসিভ।

SubscriptionNotification

SubscriptionNotification-এ নিম্নলিখিত ফিল্ড থাকে:

{
  "version": string,
  "notificationType": int,
  "purchaseToken": string
}
প্রপার্টির নাম মান বর্ণনা
ভার্সন স্ট্রিং এই বিজ্ঞপ্তির ভার্সন। প্রাথমিকভাবে, এটি "১.০"। এই ভার্সনটি অন্যান্য ভার্সন ফিল্ড থেকে আলাদা।
notificationType int সাবস্ক্রিপশনের জন্য notificationType-এর নিম্নলিখিত মান থাকতে পারে:
  • (১) SUBSCRIPTION_RECOVERED - অ্যাকাউন্ট হোল্ড থেকে সাবস্ক্রিপশন ফিরিয়ে আনা হয়েছে অথবা পজ থেকে আবার চালু করা হয়েছে।
  • (২) SUBSCRIPTION_RENEWED - একটি অ্যাক্টিভ সাবস্ক্রিপশন রিনিউ করা হয়েছে।
  • (৩) SUBSCRIPTION_CANCELED - কোনও সাবস্ক্রিপশন স্বেচ্ছায় বা অনিচ্ছাকৃতভাবে বাতিল করা হয়েছে। নিজে থেকে বাতিল করার ক্ষেত্রে, ব্যবহারকারী বাতিল করলে পাঠানো হয়।
  • (৪) SUBSCRIPTION_PURCHASED - নতুন সাবস্ক্রিপশন কেনা হয়েছে।
  • (৫) SUBSCRIPTION_ON_HOLD - সাবস্ক্রিপশন অ্যাকাউন্ট হোল্ডে রাখা হয়েছে (চালু করা থাকলে)।
  • (৬) SUBSCRIPTION_IN_GRACE_PERIOD - সাবস্ক্রিপশন অতিরিক্ত সময়কালে প্রবেশ করেছে (চালু করা থাকলে)।
  • (৭) SUBSCRIPTION_RESTARTED - ব্যবহারকারী Play > অ্যাকাউন্ট > সাবস্ক্রিপশন থেকে তার সাবস্ক্রিপশন ফিরিয়ে এনেছেন। ব্যবহারকারী সাবস্ক্রিপশন রিস্টোর করার সময় সেটি বাতিল করা হলেও এখনও মেয়াদ শেষ হয়নি। আরও তথ্যের জন্য, মেয়াদ শেষ হওয়ার আগে রিস্টোর করুন দেখুন।
  • (৮) SUBSCRIPTION_PRICE_CHANGE_CONFIRMED (DEPRECATED) - সাবস্ক্রিপশনের মূল্য পরিবর্তন ব্যবহারকারী সফলভাবে কনফার্ম করেছেন।
  • (৯) SUBSCRIPTION_DEFERRED - সাবস্ক্রিপশনের পুনরাবৃত্তির সময় বাড়ানো হয়েছে।
  • (১০) SUBSCRIPTION_PAUSED - সাবস্ক্রিপশন পজ করা হয়েছে।
  • (১১) SUBSCRIPTION_PAUSE_SCHEDULE_CHANGED - সাবস্ক্রিপশন পজ করার শিডিউল পরিবর্তন করা হয়েছে।
  • (১২) SUBSCRIPTION_REVOKED - মেয়াদ শেষ হওয়ার আগেই ব্যবহারকারীর থেকে সাবস্ক্রিপশন তুলে নেওয়া হয়েছে।
  • (১৩) SUBSCRIPTION_EXPIRED - সাবস্ক্রিপশনের মেয়াদ শেষ হয়ে গেছে।
  • (17) SUBSCRIPTION_ITEMS_CHANGED - সাবস্ক্রিপশন বান্ডেলের কোনও আইটেম পরিবর্তন করা হয়েছে।
  • (১৮) SUBSCRIPTION_CANCELLATION_SCHEDULED - প্রতিশ্রুতির মেয়াদ শেষ হওয়ার পরে ইনস্টলমেন্ট সাবস্ক্রিপশন বাতিল করার শিডিউল করা হয়েছে।
  • (১৯) SUBSCRIPTION_PRICE_CHANGE_UPDATED - সাবস্ক্রিপশন আইটেমের দাম পরিবর্তন সংক্রান্ত বিবরণ আপডেট করা হয়েছে।
  • (২০) SUBSCRIPTION_PENDING_PURCHASE_CANCELED - সাবস্ক্রিপশনের একটি বাকি থাকা ট্রানজ্যাকশন বাতিল করা হয়েছে।
  • (২১) SUBSCRIPTION_PLAN_TRANSITION_UPDATED - সাবস্ক্রিপশনের শিডিউল করা প্ল্যান ট্রানজিশন আপডেট করা হয়েছে (যেমন, কোনও ব্যবহারকারী রিটেনশন অফার গ্রহণ করলে)।
  • (২২) SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED - সাবস্ক্রিপশনের দাম বাড়ানোর জন্য সম্মতি দেওয়ার সময়সীমা শুরু হয়েছে অথবা ব্যবহারকারী দাম বাড়ানোর জন্য সম্মতি দিয়েছেন। এই RTDN শুধুমাত্র সেইসব অঞ্চলের সাবস্ক্রিপশনের জন্য পাঠানো হয় যেখানে দাম বাড়ানো প্রয়োজন।
purchaseToken স্ট্রিং সাবস্ক্রিপশন কেনার সময় ব্যবহারকারীর ডিভাইসে যে টোকেন প্রদান করা হয়েছে।

উদাহরণ

নতুন সাবস্ক্রিপশন কেনার জন্য বিজ্ঞপ্তির একটি উদাহরণ এখানে দেওয়া হল:

{
  "version":"1.0",
  "packageName":"com.some.thing",
  "eventTimeMillis":"1503349566168",
  "subscriptionNotification":
  {
    "version":"1.0",
    "notificationType":4,
    "purchaseToken":"PURCHASE_TOKEN"
  }
}

OneTimeProductNotification

OneTimeProductNotification-এ নিম্নলিখিত ফিল্ড থাকে:

{
  "version": string,
  "notificationType": int,
  "purchaseToken": string,
  "sku": string
}
প্রপার্টির নাম মান বর্ণনা
ভার্সন স্ট্রিং এই বিজ্ঞপ্তির ভার্সন। প্রাথমিকভাবে, এটি "১.০" হবে। এই ভার্সনটি অন্যান্য ভার্সন ফিল্ড থেকে আলাদা।
notificationType int বিজ্ঞপ্তির ধরন। এতে নিম্নলিখিত মান থাকতে পারে:
  • (১) ONE_TIME_PRODUCT_PURCHASED - ব্যবহারকারী এককালীন প্রোডাক্ট কিনেছেন।
  • (২) ONE_TIME_PRODUCT_CANCELED - এককালীন প্রোডাক্ট কেনাকাটা বাতিল বা প্রত্যাহার করা হয়েছে।
purchaseToken স্ট্রিং কেনাকাটা করার সময় ব্যবহারকারীর ডিভাইসে যে টোকেন দেওয়া হয়েছিল।
sku স্ট্রিং কেনা এককালীন প্রোডাক্ট আইডি (যেমন, "sword_001")

উদাহরণ

নতুন এক-বার ক্রয়ের জন্য বিজ্ঞপ্তির একটি উদাহরণ এখানে দেওয়া হল:

{
  "version":"1.0",
  "packageName":"com.some.thing",
  "eventTimeMillis":"1503349566168",
  "oneTimeProductNotification":
  {
    "version":"1.0",
    "notificationType":1,
    "purchaseToken":"PURCHASE_TOKEN",
    "sku":"my.sku"
  }
}

VoidedPurchaseNotification

VoidedPurchaseNotification-এ নিম্নলিখিত ফিল্ড থাকে:

প্রপার্টির নাম মান বর্ণনা

purchaseToken

string

বাতিল করা কেনাকাটার সাথে যুক্ত টোকেন। নতুন কেনাকাটা করা হলে এই তথ্য ডেভেলপারকে প্রদান করা হয়।

orderId

string

বাতিল করা ট্রানজ্যাকশনের সাথে যুক্ত অনন্য অর্ডার আইডি। একবার কেনাকাটার ক্ষেত্রে, এটি কেনাকাটার জন্য তৈরি করা একমাত্র অর্ডার আইডি দেখায়। অটোমেটিক রিনিউ হওয়া সাবস্ক্রিপশনের ক্ষেত্রে, প্রতিটি রিনিউয়াল ট্রানজ্যাকশনের জন্য একটি নতুন অর্ডার আইডি তৈরি করা হয়।

productType

int

বাতিল করা কেনাকাটার জন্য productType-এর নিম্নলিখিত মান থাকতে পারে:

  • (১) PRODUCT_TYPE_SUBSCRIPTION - একটি সাবস্ক্রিপশন কেনাকাটা বাতিল করা হয়েছে।
  • (২) PRODUCT_TYPE_ONE_TIME - এক-বার কেনাকাটা বাতিল করা হয়েছে।

refundType

int

বাতিল করা কেনাকাটার জন্য refundType-এর নিম্নলিখিত মান থাকতে পারে:

  • (১) REFUND_TYPE_FULL_REFUND - কেনাকাটা সম্পূর্ণ বাতিল করা হয়েছে।
  • (২) REFUND_TYPE_QUANTITY_BASED_PARTIAL_REFUND - পরিমাণ-ভিত্তিক আংশিক রিফান্ডের মাধ্যমে কেনাকাটা আংশিকভাবে বাতিল করা হয়েছে, শুধুমাত্র একাধিক পরিমাণ কেনাকাটার ক্ষেত্রে প্রযোজ্য। কোনও কেনাকাটা একাধিকবার আংশিকভাবে বাতিল করা যেতে পারে।

মনে রাখবেন, একাধিক পরিমাণ কেনাকাটার অবশিষ্ট মোট পরিমাণ রিফান্ড করা হলে, refundType হবে REFUND_TYPE_FULL_REFUND।

উদাহরণ

নতুন বাতিল করা কেনাকাটার জন্য বিজ্ঞপ্তির একটি উদাহরণ এখানে দেওয়া হল:

{
  "version":"1.0",
  "packageName":"com.some.app",
  "eventTimeMillis":"1503349566168",
  "voidedPurchaseNotification":
  {
    "purchaseToken":"PURCHASE_TOKEN",
    "orderId":"GS.0000-0000-0000",
    "productType":1
    "refundType":1
  }
}

VoidedPurchaseNotification ব্যবহার করা হচ্ছে

আপনার RTDN ক্লায়েন্ট VoidedPurchaseNotification পেলে, নিম্নলিখিত তথ্য মনে রাখবেন:

  • packageName: অ্যাপ শনাক্ত করে।
  • eventTimeMillis: স্ট্যাটাস কখন পরিবর্তন হয়েছে তা আপনাকে জানায়।
  • purchaseToken: প্রোডাক্ট কেনার সময় ব্যবহারকারীর ডিভাইসে যে টোকেন প্রদান করা হয়েছে।
  • orderId: বাতিল করা ট্রানজ্যাকশনের সাথে যুক্ত অর্ডার শনাক্ত করে।
  • productType: বাতিল করা কেনাকাটাটি অ্যাপ-মধ্যস্থ কেনাকাটা নাকি সাবস্ক্রিপশন ছিল তা নির্দেশ করে।
  • refundType: কেনাকাটা বাতিল করার জন্য যে ধরনের রিফান্ড করা হয়েছে তা নির্দিষ্ট করে।

PendingRefundReviewNotification

কোনও ব্যবহারকারী কেনাকাটার জন্য চার্জব্যাক করার অনুরোধ করলে এবং অনুরোধটি ডেভেলপারের পর্যালোচনা করার প্রয়োজন হলে, একটি PendingRefundReviewNotification পাঠানো হয়। আপনি এই বিজ্ঞপ্তি পেলে, অনুরোধটি মূল্যায়ন করা উচিত এবং ReviewRefund API কল করে ২৪ ঘণ্টার মধ্যে রিফান্ডের সাজেশন এবং কেনাকাটার ব্যবহার সংক্রান্ত প্রমাণ প্রদান করা উচিত।

PendingRefundReviewNotification-এ নিম্নলিখিত ফিল্ড থাকে:

{
  "version": string,
  "pendingRefundToken": string,
  "orderId": string,
  "refundReason": int,
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string
}
প্রপার্টির নাম মান বর্ণনা
ভার্সন স্ট্রিং এই বিজ্ঞপ্তির ভার্সন। প্রাথমিকভাবে, এটি "১.০"। এই ভার্সনটি অন্যান্য ভার্সন ফিল্ড থেকে আলাদা।
pendingRefundToken স্ট্রিং একটি অনন্য টোকেন যা পর্যালোচনার অধীনে থাকা রিফান্ডের অনুরোধ শনাক্ত করে। ReviewRefund API কল করার সময় এই টোকেন পাস করুন।
orderId স্ট্রিং যে কেনাকাটার জন্য রিফান্ড সংক্রান্ত রিভিউ পেন্ডিং আছে, সেটির অর্ডার আইডি।
refundReason int রিফান্ডের অনুরোধ করার কারণ। পেন্ডিং রিভিউতে রিফান্ডের কারণ হিসেবে শুধু CHARGEBACK (৭) কাজ করে। নতুন কারণ উপলভ্য হওয়ার সাথে সাথে আপনার কোডকে সেগুলি ম্যানেজ করতে হবে।
obfuscatedAccountId স্ট্রিং (প্রযোজ্য হলে) কেনাকাটা করার সময় ডেভেলপার-নির্দিষ্ট ব্যবহারকারীর অ্যাকাউন্টের যে অস্পষ্ট আইডি দেওয়া হয়েছিল।
obfuscatedProfileId স্ট্রিং (প্রযোজ্য হলে) কেনাকাটা করার সময় ডেভেলপার-নির্দিষ্ট প্রোফাইল আইডি যা সরবরাহ করা হয়েছিল।

উদাহরণ

এখানে রিফান্ড সংক্রান্ত পর্যালোচনার বিজ্ঞপ্তি পেন্ডিং থাকার একটি উদাহরণ দেওয়া হল:

{
  "version":"1.0",
  "packageName":"com.some.thing",
  "eventTimeMillis":"1503350156918",
  "pendingRefundReviewNotification":
  {
    "version":"1.0",
    "pendingRefundToken":"example-token",
    "orderId":"GPA.1234-5678-9012-34567",
    "refundReason":7,
    "obfuscatedAccountId":"user-account-id",
    "obfuscatedProfileId":"user-profile-id"
  }
}

TestNotification

TestNotification-এ নিম্নলিখিত ফিল্ড থাকে:

{
  "version": string
}
প্রপার্টির নাম মান বর্ণনা
ভার্সন স্ট্রিং এই বিজ্ঞপ্তির ভার্সন। প্রাথমিকভাবে, এটি "১.০"। এই ভার্সনটি অন্যান্য ভার্সন ফিল্ড থেকে আলাদা।

উদাহরণ

এখানে টেস্ট বিজ্ঞপ্তির একটি উদাহরণ দেওয়া হল:

{
  "version":"1.0",
  "packageName":"com.some.thing",
  "eventTimeMillis":"1503350156918",
  "testNotification":
  {
    "version":"1.0"
  }
}