ডিভাইস গ্রুপ মেসেজিংয়ের মাধ্যমে আপনি একটি গ্রুপে একাধিক ডিভাইস যোগ করতে পারবেন। এটি টপিক মেসেজিংয়ের মতোই, তবে এতে যাচাইকরণ অন্তর্ভুক্ত থাকে যাতে নিশ্চিত করা যায় যে গ্রুপ মেম্বারশিপ শুধুমাত্র আপনার সার্ভার দ্বারা ম্যানেজ করা হয়।
যেমন, আপনি যদি বিভিন্ন ফোন মডেলে আলাদা আলাদা মেসেজ পাঠাতে চান, তাহলে আপনার সার্ভার উপযুক্ত গ্রুপে রেজিস্ট্রেশন যোগ করতে বা সরাতে পারে এবং প্রতিটি গ্রুপে উপযুক্ত মেসেজ পাঠাতে পারে। ডিভাইস গ্রুপ মেসেজিং, বিষয় মেসেজিংয়ের থেকে আলাদা কারণ এতে আপনার অ্যাপ্লিকেশনের মধ্যে সরাসরি ম্যানেজ করার পরিবর্তে আপনার সার্ভার থেকে ডিভাইস গ্রুপ ম্যানেজ করা হয়।
বিজ্ঞপ্তি কীতে সর্বাধিক ২০ জন মেম্বারকে অনুমতি দেওয়া হয়।
ডিভাইস গ্রুপ ম্যানেজ করা
ডিভাইস গ্রুপে মেসেজ পাঠানোর আগে, আপনাকে অবশ্যই:
- আপনি গ্রুপে যোগ করতে চান এমন প্রতিটি ডিভাইসের জন্য রেজিস্ট্রেশন টোকেন পান।
notification_keyতৈরি করুন, যা কোনও নির্দিষ্ট গ্রুপকে (সাধারণত একজন ব্যবহারকারী) গ্রুপের সাথে সম্পর্কিত সব রেজিস্ট্রেশন টোকেনের সাথে ম্যাপ করার মাধ্যমে ডিভাইস গ্রুপ শনাক্ত করে। আপনি অ্যাপ সার্ভারে বিজ্ঞপ্তি কী তৈরি করতে পারবেন।
ডিভাইস গ্রুপের প্রাথমিক ম্যানেজমেন্ট — গ্রুপ তৈরি করা ও সরানো এবং ডিভাইস যোগ করা বা সরানো — HTTP v1 API ব্যবহার করে করা হয়, অনুমোদন পাঠানোর অনুরোধ করতে স্বল্প-মেয়াদী টোকেন ব্যবহার করা হয়। কাজ করে এমন 'কী'-এর তালিকা দেখতে ডিভাইস গ্রুপ ম্যানেজমেন্ট 'কী' দেখুন।
অ্যাপ সার্ভারে ডিভাইস গ্রুপ ম্যানেজ করা
ডিভাইস গ্রুপ তৈরি করা
ডিভাইস গ্রুপ তৈরি করতে, একটি পোস্ট রিকোয়েস্ট পাঠান যাতে গ্রুপের নাম এবং ডিভাইসের জন্য রেজিস্ট্রেশন টোকেনের তালিকা থাকে। FCM
একটি নতুন notification_key রিটার্ন করে যা ডিভাইস গ্রুপকে দেখায়।
HTTP POST অনুরোধ
https://fcm.googleapis.com/fcm/notification-এ
নিম্নলিখিত অনুরোধের মতো অনুরোধ পাঠান:
https://fcm.googleapis.com/fcm/notification
Content-Type:application/json
access_token_auth: true
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA
project_id:SENDER_ID
{
"operation": "create",
"notification_key_name": "appUser-Chris",
"registration_ids": ["bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
"cR1rjyj4_Kc:APA91bGusqbypSuMdsh7jSNrW4nzsM...",
... ]
}
notification_key_name হল একটি নাম বা শনাক্তকারী (যেমন, এটি একটি
ইউজারনেম হতে পারে) যা প্রদত্ত গ্রুপের জন্য অনন্য। notification_key_name এবং
notification_key হল রেজিস্ট্রেশন টোকেনের গ্রুপের জন্য অনন্য। একই প্রেরক আইডির জন্য একাধিক ক্লায়েন্ট অ্যাপ থাকলে,
প্রতিটি ক্লায়েন্ট অ্যাপের জন্য notification_key_name অনন্য হওয়া
প্রয়োজন।
এটি নিশ্চিত করে যে মেসেজ শুধুমাত্র নির্দিষ্ট টার্গেট অ্যাপেই যাবে।
রেসপন্স ফর্ম্যাট
অনুরোধ সফল হলে, নিচে দেখানো উদাহরণের মতো একটি notification_key রিটার্ন করা হয়:
{
"notification_key": "APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ"
}
পরবর্তী অপারেশনে ব্যবহার করার জন্য notification_key এবং সংশ্লিষ্ট notification_key_name সেভ করুন।
বিজ্ঞপ্তি কী ফিরিয়ে আনা হচ্ছে
আগে থেকে থাকা কোনও বিজ্ঞপ্তি কী ফিরিয়ে আনতে হলে,
notification_key_name GET অনুরোধে এইভাবে ব্যবহার করুন:
https://fcm.googleapis.com/fcm/notification?notification_key_name=appUser-Chris
Content-Type:application/json
access_token_auth: true
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA
project_id:SENDER_ID
{}
প্রদত্ত বিজ্ঞপ্তি কী নামের জন্য প্রতিটি GET অনুরোধের জন্য, সার্ভার একটি অনন্য এনকোড করা স্ট্রিং ফেরত দেয়। যদিও প্রতিটি স্ট্রিং আলাদা আলাদা কী হিসেবে দেখা যেতে পারে,
এটি আসলে একটি সঠিক notification_key ভ্যালু।
ডিভাইস গ্রুপের জন্য FCMটি টোকেন ফিরিয়ে আনা হচ্ছে
কোনও ডিভাইস গ্রুপের FCM টোকেন ফিরিয়ে আনতে হলে,
notification_key GET অনুরোধে ব্যবহার করুন, যেমন দেখানো হয়েছে:
https://fcm.googleapis.com/fcm/notification?notification_key=APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ
Content-Type:application/json
access_token_auth: true
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA
project_id:SENDER_ID
{}
উত্তরটি এইরকম দেখতে:
{
"notification_key_name": "appUser-Chris",
"registration_ids": ["token1", "token2"]
}
ডিভাইস গ্রুপে ডিভাইস যোগ করা ও সরিয়ে দেওয়া
আগে থেকে থাকা কোনও গ্রুপে ডিভাইস যোগ করতে বা সেখান থেকে সরাতে, operation প্যারামিটার add বা remove-এ সেট করে POST অনুরোধ পাঠান এবং যোগ করা বা সরানোর জন্য রেজিস্ট্রেশন টোকেন প্রদান করুন।
HTTP POST অনুরোধ
যেমন, bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1... থেকে appUser-Chris রেজিস্ট্রেশন টোকেন সহ কোনও ডিভাইস যোগ করতে,
আপনাকে এই অনুরোধ পাঠাতে হবে:
https://fcm.googleapis.com/fcm/notification
Content-Type:application/json
access_token_auth: true
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA
project_id:SENDER_ID
{
"operation": "add",
"notification_key_name": "appUser-Chris",
"notification_key": "APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ",
"registration_ids": ["bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1..."]
}
রেসপন্স ফর্ম্যাট
কোনও ডিভাইস যোগ বা সরানোর অনুরোধ সফল হলে, নিম্নলিখিত
notification_key-এর মতো একটি মেসেজ দেখানো হয়:
{ "notification_key": "APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ" }
ডিভাইস গ্রুপ ম্যানেজমেন্ট কী
নিম্নলিখিত সারণীতে ডিভাইস গ্রুপ তৈরি করা এবং মেম্বার যোগ করা ও সরানোর জন্য কীগুলি তালিকাভুক্ত করা হয়েছে।
| প্যারামিটার | ব্যবহার | বিবরণ |
|---|---|---|
operation |
প্রয়োজনীয়, স্ট্রিং | রান করার জন্য অপারেশন। সঠিক ভ্যালু হল create, add এবং remove। |
notification_key_name |
প্রয়োজনীয়, স্ট্রিং | ডিভাইস গ্রুপের ব্যবহারকারী-নির্ধারিত নাম তৈরি বা পরিবর্তন করতে হবে। |
notification_key |
প্রয়োজনীয় (create অপারেশন, স্ট্রিং ছাড়া) |
ডিভাইস গ্রুপের অনন্য শনাক্তকারী। create অপারেশন সফল হলে এই ভ্যালু রেসপন্সে দেখানো হয় এবং ডিভাইস গ্রুপের পরবর্তী সব অপারেশনের জন্য এটি প্রয়োজন হয়। |
registration_ids |
প্রয়োজনীয়, স্ট্রিংয়ের অ্যারে | ডিভাইস টোকেন যোগ করা বা সরানো। আপনি কোনও ডিভাইস গ্রুপ থেকে আগে থেকে থাকা সব রেজিস্ট্রেশন টোকেন সরিয়ে দিলে, FCM সেই ডিভাইস গ্রুপ মুছে দেয়। |
ডিভাইস গ্রুপে মেসেজ পাঠানো
কোনও ডিভাইস গ্রুপে মেসেজ পাঠানো, কোনও স্বতন্ত্র ডিভাইসে মেসেজ পাঠানোর মতোই, অনুমোদিত পাঠানোর
অনুরোধ-এর জন্য একই পদ্ধতি ব্যবহার করা হয়।
token ফিল্ডটি গ্রুপ বিজ্ঞপ্তি কীতে সেট করুন:
REST
POST https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send HTTP/1.1
Content-Type: application/json
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA
{
"message":{
"token":"APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ",
"data":{
"hello": "This is a Firebase Cloud Messaging device group message!"
}
}
}
cURL কমান্ড
curl -X POST -H "Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA" -H "Content-Type: application/json" -d '{
"message":{
"data":{
"hello": "This is a Firebase Cloud Messaging device group message!"
},
"token":"APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ"
}}' https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send