C++ पर डिवाइस ग्रुप को मैसेज भेजें

डिवाइस ग्रुप मैसेजिंग की सुविधा की मदद से, एक ही ग्रुप में कई डिवाइस जोड़े जा सकते हैं. यह विषय के हिसाब से मैसेज करने की सुविधा जैसा ही है. हालांकि, इसमें पुष्टि करने की सुविधा शामिल होती है, ताकि यह पक्का किया जा सके कि ग्रुप की सदस्यता सिर्फ़ आपके सर्वर मैनेज करते हैं. उदाहरण के लिए, अगर आपको अलग-अलग फ़ोन मॉडल के लिए अलग-अलग मैसेज भेजने हैं, तो आपके सर्वर सही ग्रुप में रजिस्ट्रेशन जोड़/हटा सकते हैं और हर ग्रुप को सही मैसेज भेज सकते हैं. डिवाइस ग्रुप मैसेजिंग, विषय के हिसाब से मैसेज करने की सुविधा से अलग होती है. इसमें, डिवाइस ग्रुप को सीधे तौर पर ऐप्लिकेशन में मैनेज करने के बजाय, सर्वर से मैनेज किया जाता है.

सूचना कुंजी वाले सदस्यों की संख्या ज़्यादा से ज़्यादा 20 हो सकती है.

डिवाइस ग्रुप मैनेज करना

किसी डिवाइस ग्रुप को मैसेज भेजने से पहले, ज़रूरी है कि:

1. हर उस डिवाइस के लिए रजिस्ट्रेशन टोकन पाएं जिसे आपको ग्रुप में जोड़ना है.

2. notification_key बनाएं. यह किसी खास ग्रुप (आम तौर पर उपयोगकर्ता) को, ग्रुप से जुड़े सभी रजिस्टरेशन टोकन से मैप करके, डिवाइस ग्रुप की पहचान करता है. ऐप्लिकेशन सर्वर पर सूचना कुंजियां बनाई जा सकती हैं.

डिवाइस ग्रुप का बुनियादी मैनेजमेंट, एचटीटीपी v1 एपीआई के ज़रिए किया जाता है. इसमें ग्रुप बनाना और हटाना, डिवाइस जोड़ना या हटाना शामिल है. साथ ही, अनुरोध भेजने की अनुमति देने के लिए, कुछ समय के लिए बने रहने वाले टोकन का इस्तेमाल किया जाता है. इस्तेमाल की जा सकने वाली कुंजियों की सूची देखने के लिए, डिवाइस ग्रुप मैनेजमेंट पासकोड देखें.

ऐप्लिकेशन सर्वर पर डिवाइस ग्रुप मैनेज करना

डिवाइस ग्रुप बनाया जा रहा है

डिवाइस ग्रुप बनाने के लिए, एक POST अनुरोध भेजें. इसमें ग्रुप का नाम और डिवाइसों के रजिस्ट्रेशन टोकन की सूची शामिल होनी चाहिए. FCM, डिवाइस ग्रुप के बारे में बताने वाला नया notification_key दिखाता है.

एचटीटीपी पोस्ट अनुरोध

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 का इस्तेमाल करें, जैसा कि यहां दिखाया गया है:

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 अनुरोध के लिए, सर्वर एक यूनीक कोड की गई स्ट्रिंग दिखाता है. हालांकि, हर स्ट्रिंग एक अलग कुंजी के तौर पर दिख सकती है, लेकिन असल में यह एक मान्य `सूचना_की` वैल्यू है.

डिवाइस ग्रुप में डिवाइसों को जोड़ना और हटाना

किसी मौजूदा ग्रुप में डिवाइस जोड़ने या हटाने के लिए, operation पैरामीटर को add या remove पर सेट करके, पोस्ट अनुरोध भेजें. साथ ही, डिवाइस जोड़ने या हटाने के लिए रजिस्ट्रेशन टोकन दें.

किसी डिवाइस ग्रुप से सभी मौजूदा रजिस्ट्रेशन टोकन हटाने पर, FCM डिवाइस ग्रुप मिट जाता है.

एचटीटीपी पोस्ट अनुरोध

उदाहरण के लिए, bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1... रजिस्ट्रेशन टोकन वाले डिवाइस को appUser-Chris में जोड़ने के लिए, यह अनुरोध भेजें:

{
   "operation": "add",
   "notification_key_name": "appUser-Chris",
   "notification_key": "APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ",
   "registration_ids": ["bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1..."]
}

जवाब का फ़ॉर्मैट

किसी डिवाइस को जोड़ने या हटाने का अनुरोध पूरा होने पर, आपको इस तरह का notification_key दिखेगा:

{
   "notification_key": "APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ"
}

ध्यान दें: रजिस्ट्रेशन टोकन जोड़ने या हटाने के लिए, notification_key_name देना ज़रूरी नहीं है. हालांकि, इसे शामिल करने से, गलती से गलत notification_key का इस्तेमाल करने से बचा जा सकता है.

डिवाइस ग्रुप मैनेज करने की कुंजियां

नीचे दी गई टेबल में, डिवाइस ग्रुप बनाने, सदस्यों को जोड़ने, और हटाने के लिए कुंजियों की सूची दी गई है.

टेबल 10. डिवाइस ग्रुप मैनेजमेंट पासकोड.

पैरामीटर	इस्तेमाल	ब्यौरा
operation	ज़रूरी है, स्ट्रिंग	चलाने के लिए मान्य वैल्यू.ये वैल्यू create, add, और remove हैं.
notification_key_name	ज़रूरी है, स्ट्रिंग	डिवाइस ग्रुप बनाने या उसमें बदलाव करने के लिए, उपयोगकर्ता का तय किया गया नाम.
notification_key	ज़रूरी है (create ऑपरेशन, स्ट्रिंग को छोड़कर	डिवाइस ग्रुप का यूनीक आइडेंटिफ़ायर. यह वैल्यू, create ऑपरेशन के सही तरीके से होने पर रिस्पॉन्स में दिखती है. साथ ही, डिवाइस ग्रुप पर होने वाले सभी बाद के ऑपरेशन के लिए ज़रूरी है.
registration_ids	स्ट्रिंग का कलेक्शन ज़रूरी है	जो डिवाइस टोकन जोड़ने या हटाने हैं. अगर किसी डिवाइस ग्रुप से सभी मौजूदा रजिस्ट्रेशन टोकन हटाए जाते हैं, तो FCM डिवाइस ग्रुप को मिटा देता है.

डिवाइस ग्रुप को डाउनस्ट्रीम मैसेज भेजे जा रहे हैं

डिवाइस ग्रुप को मैसेज भेजने के लिए, एचटीटीपी v1 API का इस्तेमाल करें. अगर फ़िलहाल, एचटीटीपी या एक्सएमपीपी के लिए, इस्तेमाल नहीं किए जा रहे लेगसी सेंड एपीआई का इस्तेमाल करके डिवाइस ग्रुप को मैसेज भेजे जा रहे हैं या लेगसी प्रोटोकॉल के आधार पर, Node.js के लिए Firebase Admin SDK के किसी पुराने वर्शन का इस्तेमाल किया जा रहा है, तो हमारा सुझाव है कि आप जल्द से जल्द एचटीटीपी v1 एपीआई पर माइग्रेट करें. ईमेल भेजने के लिए इस्तेमाल होने वाले लेगसी एपीआई, जून 2024 में बंद कर दिए जाएंगे और हटा दिए जाएंगे.

किसी डिवाइस ग्रुप को मैसेज भेजना, किसी एक डिवाइस को मैसेज भेजने जैसा ही है. मैसेज भेजने के अनुरोधों को अनुमति देने के लिए, एक ही तरीके का इस्तेमाल किया जाता है. 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

ध्यान दें: बंद किए गए लेगसी एपीआई में, डिवाइस ग्रुप भेजने के तरीकों के मुकाबले, HTTP v1 के जवाब में, सफल और असफल अनुरोधों की संख्या शामिल नहीं होती. सही तरीके से भेजने पर, जवाब के तौर पर खाली जवाब मिलता है.