Firebase क्लाउड से मैसेज के साथ XMPP प्रोटोकॉल

यह दस्तावेज़ पास करने के लिए इस्तेमाल किए जाने वाले XMPP सिंटैक्स का रेफ़रंस देता है मैसेज, जो आपके ऐप्लिकेशन सर्वर, क्लाइंट ऐप्लिकेशन, और Firebase क्लाउड से मैसेज (FCM) के बीच मैसेज भेज रहे हैं. आपके ऐप्लिकेशन सर्वर को इन एंडपॉइंट से कनेक्ट करना होगा:

// Production
fcm-xmpp.googleapis.com:5235

// Testing
fcm-xmpp.googleapis.com:5236

उपलब्ध पैरामीटर और विकल्पों को इन कैटगरी में बांटा जा सकता है:

डाउनस्ट्रीम मैसेज सिंटैक्स

यह सेक्शन डाउनस्ट्रीम मैसेज भेजने के लिए सिंटैक्स देता है.

डाउनस्ट्रीम XMPP मैसेज (JSON)

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

पहली टेबल डाउनस्ट्रीम XMPP मैसेज (JSON) के लिए टारगेट, विकल्प, और पेलोड.

पैरामीटर इस्तेमाल किए जाने से जुड़ी जानकारी ब्यौरा
टारगेट
to ज़रूरी नहीं, स्ट्रिंग

इस पैरामीटर से, मैसेज पाने वाले के बारे में पता चलता है.

यह वैल्यू किसी डिवाइस का रजिस्ट्रेशन टोकन, डिवाइस ग्रुप का हो सकता है या कोई एक विषय (जिसमें /topics/). कई विषयों को भेजने के लिए, condition पैरामीटर.

condition ज़रूरी नहीं, स्ट्रिंग

यह पैरामीटर शर्तों का ऐसा लॉजिकल एक्सप्रेशन तय करता है जो मैसेज टारगेट तय करता है.

इस्तेमाल की जा सकने वाली शर्त: विषय, "'yourtopic' के तौर पर फ़ॉर्मैट किया गया विषय चुनें". यह वैल्यू, केस-इनसेंसिटिव होती है.

इस्तेमाल किए जा सकने वाले ऑपरेटर: &&, ||. ज़्यादा से ज़्यादा दो ऑपरेटर प्रति विषय संदेश समर्थित हैं.
विकल्प
message_id ज़रूरी स्ट्रिंग

यह पैरामीटर किसी XMPP कनेक्शन में किसी मैसेज की खास तौर पर पहचान करता है.
collapse_key ज़रूरी नहीं, स्ट्रिंग

यह पैरामीटर मैसेज के एक ग्रुप की पहचान करता है (उदाहरण के लिए, collapse_key: "Updates Available") को छोटा किया जा सकता है, ताकि सिर्फ़ वितरण को फिर से शुरू करने पर अंतिम संदेश भेजा जाता है. ऐसा इसलिए किया गया है, ताकि ईमेल भेजने से बचा जा सके डिवाइस के वापस ऑनलाइन आने या बैटरी खत्म होने पर, आपको एक ही तरह के कई मैसेज दिखेंगे.

इस बात की कोई गारंटी नहीं है कि मैसेज किस क्रम में भेजे जाएंगे.

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

priority ज़रूरी नहीं, स्ट्रिंग

मैसेज की प्राथमिकता सेट करता है. मान्य मान "सामान्य" हैं और "ज़्यादा". Apple प्लैटफ़ॉर्म पर, ये एपीएन की प्राथमिकताएं 5 और 10 के मुताबिक हैं.

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

जब किसी मैसेज को ज़्यादा प्राथमिकता के साथ भेजा जाता है, तो उसे तुरंत भेज दिया जाता है. साथ ही, ऐप्लिकेशन में सूचना दिखाई जा सकती है.

content_available वैकल्पिक, बूलियन

Apple प्लैटफ़ॉर्म पर, एपीएन में content-available दिखाने के लिए, इस फ़ील्ड का इस्तेमाल करें पेलोड. जब कोई सूचना या मैसेज भेजा जाता है और इसे true पर सेट किया जाता है, तो इस्तेमाल न किया जा रहा क्लाइंट ऐप्लिकेशन चालू हो जाता है और एपीएन के ज़रिए साइलेंट ऐप्लिकेशन के तौर पर मैसेज भेजा जाता है के ज़रिए भेजा जा सकता है. ध्यान दें कि आवाज़ के बिना मिलने वाली सूचनाएं एपीएन डिलीवर होने की गारंटी नहीं देते. इसके लिए, यह उपयोगकर्ता जैसी चीज़ों पर निर्भर हो सकता है 'कम पावर मोड' चालू करना, ऐप्लिकेशन को ज़बरदस्ती बंद करना वगैरह. Android पर, डेटा मैसेज डिफ़ॉल्ट रूप से ऐप. फ़िलहाल, यह सुविधा Chrome पर काम नहीं करती.
mutable_content ज़रूरी नहीं, JSON बूलियन

Apple प्लैटफ़ॉर्म पर, दिखाने के लिए इस फ़ील्ड का इस्तेमाल करें एपीएन पेलोड में mutable-content. सूचना भेजे जाने और सूचना पाने की सुविधा सेट किए जाने पर true तक, सूचना के कॉन्टेंट को दिखाने से पहले बदला जा सकता है, का उपयोग करके सूचना सेवा ऐप्लिकेशन एक्सटेंशन. Android और वेब के लिए इस पैरामीटर को अनदेखा कर दिया जाएगा.

time_to_live ज़रूरी नहीं है, नंबर

यह पैरामीटर तय करता है कि मैसेज को FCM स्टोरेज में कितने समय तक (सेकंड में) रखना चाहिए अगर डिवाइस ऑफ़लाइन है. लाइव स्ट्रीम में ज़्यादा से ज़्यादा चार हफ़्ते लग सकते हैं. डिफ़ॉल्ट रूप से, इसकी अवधि चार हफ़्ते होती है. ज़्यादा जानकारी के लिए, मैसेज की अवधि तय करना देखें.

dry_run वैकल्पिक, बूलियन

इस पैरामीटर को true पर सेट करके, डेवलपर अनुरोध पर कार्रवाई नहीं कर सकते.

डिफ़ॉल्ट वैल्यू false है.
पेलोड
data ज़रूरी नहीं, ऑब्जेक्ट

यह पैरामीटर मैसेज के पेलोड के की-वैल्यू पेयर को तय करता है.

उदाहरण के लिए, data:{"score":"3x1"}: के साथ

Apple प्लैटफ़ॉर्म पर, अगर एपीएन से मैसेज डिलीवर किया जाता है, तो यह कस्टम डेटा फ़ील्ड को दिखाता है. अगर आपने इसे FCM से डिलीवर किया जाता है, इसे AppDelegate application:didReceiveRemoteNotification: में की-वैल्यू डिक्शनरी के तौर पर दिखाया जाता है.

Android पर, इससे स्ट्रिंग वैल्यू 3x1 के साथ score नाम का इंटेंट एक्स्ट्रा मिलता है.

कुंजी कोई रिज़र्व शब्द ("from", "message_type" या इससे शुरू होने वाला कोई भी शब्द नहीं होना चाहिए "Google" या "gcm") है. इस टेबल में तय किए गए किसी भी शब्द का इस्तेमाल न करें (जैसे कि collapse_key).

स्ट्रिंग टाइप में वैल्यू का सुझाव दिया जाता है. आपको ऑब्जेक्ट या अन्य नॉन-स्ट्रिंग डेटा टाइप में वैल्यू बदलनी होंगी (उदाहरण के लिए, पूर्णांक या बूलियन) को स्ट्रिंग में बदलें.
notification ज़रूरी नहीं, ऑब्जेक्ट यह पैरामीटर सूचना पेलोड. ज़्यादा जानकारी के लिए, सूचना पेलोड से जुड़ी सहायता देखें. Reader Revenue Manager को सेट अप करने के बारे में सूचना मैसेज और डेटा मैसेज के विकल्पों के बारे में जानने के लिए, मैसेज के टाइप. अगर सूचना पेलोड दिया गया है, या Apple को मैसेज भेजने के लिए, content_available विकल्प को true पर सेट किया गया है तो मैसेज को एपीएन के ज़रिए भेजा जाता है. अगर ऐसा नहीं है, तो यह FCM.

सूचना पेलोड से जुड़ी सहायता

इन टेबल में, की, Apple प्लैटफ़ॉर्म और Android के लिए सूचना वाले मैसेज बनाने के लिए उपलब्ध हैं.

टेबल 2a. Apple — सूचना मैसेज के लिए बटन

पैरामीटर इस्तेमाल किए जाने से जुड़ी जानकारी ब्यौरा
title ज़रूरी नहीं, स्ट्रिंग

सूचना का टाइटल.

यह फ़ील्ड फ़ोन और टैबलेट पर नहीं दिखता.

body ज़रूरी नहीं, स्ट्रिंग

सूचना का मुख्य टेक्स्ट.

sound ज़रूरी नहीं, स्ट्रिंग

डिवाइस को सूचना मिलने पर चलने वाली आवाज़.

स्ट्रिंग, जो क्लाइंट ऐप्लिकेशन के मुख्य बंडल या ऐप्लिकेशन के डेटा कंटेनर का Library/Sounds फ़ोल्डर. ज़्यादा जानकारी के लिए, iOS डेवलपर लाइब्रेरी पर जाएं.

badge ज़रूरी नहीं, स्ट्रिंग

होम स्क्रीन ऐप्लिकेशन आइकॉन पर बैज की वैल्यू.

अगर इसके बारे में नहीं बताया गया है, तो बैज में कोई बदलाव नहीं होता.

अगर इस बैज को 0 पर सेट किया जाता है, तो इसे हटा दिया जाता है.

click_action ज़रूरी नहीं, स्ट्रिंग

सूचना पर क्लिक करने से जुड़ी उपयोगकर्ता की कार्रवाई.

एपीएन पेलोड में मौजूद category से मेल खाता है.

subtitle ज़रूरी नहीं, स्ट्रिंग

सूचना का सबटाइटल.

body_loc_key ज़रूरी नहीं, स्ट्रिंग

ऐप्लिकेशन के स्ट्रिंग रिसॉर्स में मौजूद बॉडी स्ट्रिंग की कुंजी का इस्तेमाल उपयोगकर्ता के मौजूदा स्थानीय भाषा के मुताबिक लेख के मुख्य हिस्से को स्थानीय भाषा में उपलब्ध कराएं.

एपीएन पेलोड में मौजूद loc-key से मेल खाता है.

यहां जाएं: पेलोड कुंजी का रेफ़रंस और ज़्यादा जानकारी के लिए, रिमोट नोटिफ़िकेशन के कॉन्टेंट को स्थानीय भाषा में उपलब्ध कराना जानकारी.

body_loc_args ज़रूरी नहीं है. JSON फ़ॉर्मैट में अरे को स्ट्रिंग के तौर पर दिखाया गया है

फ़ॉर्मैट की खास जानकारी देने वाले टूल की जगह इस्तेमाल की जाने वाली वैरिएबल स्ट्रिंग की वैल्यू लेख में मौजूद मुख्य हिस्से को स्थानीय भाषा में लिखने के लिए, body_loc_key उपयोगकर्ता के मौजूदा स्थानीय भाषा के मुताबिक होना चाहिए.

एपीएन पेलोड में मौजूद loc-args से मेल खाता है.

यहां जाएं: पेलोड कुंजी का रेफ़रंस और ज़्यादा जानकारी के लिए, रिमोट नोटिफ़िकेशन के कॉन्टेंट को स्थानीय भाषा में उपलब्ध कराना जानकारी.

title_loc_key ज़रूरी नहीं, स्ट्रिंग

ऐप्लिकेशन के स्ट्रिंग रिसॉर्स में टाइटल स्ट्रिंग का इस्तेमाल करने के लिए उपयोगकर्ता के वर्तमान स्थानीय भाषा के अनुसार शीर्षक टेक्स्ट का स्थानीयकरण करें.

एपीएन पेलोड में मौजूद title-loc-key से मेल खाता है.

यहां जाएं: पेलोड कुंजी का रेफ़रंस और ज़्यादा जानकारी के लिए, रिमोट नोटिफ़िकेशन के कॉन्टेंट को स्थानीय भाषा में उपलब्ध कराना जानकारी.

title_loc_args ज़रूरी नहीं है. JSON फ़ॉर्मैट में अरे को स्ट्रिंग के तौर पर दिखाया गया है

फ़ॉर्मैट की खास जानकारी देने वाले टूल की जगह इस्तेमाल की जाने वाली वैरिएबल स्ट्रिंग की वैल्यू मूल टेक्स्ट को स्थानीय भाषा में लिखने के लिए, title_loc_key का इस्तेमाल करें उपयोगकर्ता के मौजूदा स्थानीय भाषा के मुताबिक होना चाहिए.

एपीएन पेलोड में मौजूद title-loc-args से मेल खाता है.

यहां जाएं: पेलोड कुंजी का रेफ़रंस और ज़्यादा जानकारी के लिए, रिमोट नोटिफ़िकेशन के कॉन्टेंट को स्थानीय भाषा में उपलब्ध कराना जानकारी.

टेबल 2b. Android — सूचना मैसेज के लिए बटन

पैरामीटर इस्तेमाल किए जाने से जुड़ी जानकारी ब्यौरा
title ज़रूरी नहीं, स्ट्रिंग

सूचना का टाइटल.

body ज़रूरी नहीं, स्ट्रिंग

सूचना का मुख्य टेक्स्ट.

android_channel_id ज़रूरी नहीं, स्ट्रिंग

सूचना का चैनल आईडी (Android O में नया).

इस चैनल आईडी के साथ कोई भी सूचना पाने से पहले, ऐप्लिकेशन को इस चैनल आईडी के साथ एक चैनल बनाना होगा मिला.

अगर आपने अनुरोध में यह चैनल आईडी नहीं भेजा या आपने जो चैनल आईडी दिया है वह अब तक नहीं भेजा गया है अगर FCM, ऐप्लिकेशन मेनिफ़ेस्ट में बताए गए चैनल आईडी का इस्तेमाल करता है, तो

icon ज़रूरी नहीं, स्ट्रिंग

सूचना का आइकॉन.

ड्रॉ करने लायक संसाधन के लिए सूचना आइकॉन को myicon पर सेट करता है myicon. अगर अनुरोध में इस कुंजी को नहीं भेजा जाता है, तो FCM आपके ऐप्लिकेशन मेनिफ़ेस्ट में तय किया गया लॉन्चर आइकॉन दिखाता है.

sound ज़रूरी नहीं, स्ट्रिंग

डिवाइस को सूचना मिलने पर चलने वाली आवाज़.

"default" या साउंड रिसॉर्स के फ़ाइल नाम के साथ काम किया जा सकता है ऐप्लिकेशन में बंडल किए गए हों. साउंड फ़ाइलें /res/raw/ में होनी चाहिए.

tag ज़रूरी नहीं, स्ट्रिंग

सूचना में मौजूदा सूचनाओं को बदलने के लिए इस्तेमाल किया जाने वाला आइडेंटिफ़ायर दराज़.

अगर यह नीति तय नहीं की गई है, तो हर अनुरोध के लिए नई सूचना बनाई जा सकती है.

अगर यह बताया गया है और उसी टैग के साथ कोई सूचना पहले से मौजूद है जब सूचना मिलेगी, तो नई सूचना नोटिफ़िकेशन पैनल.

color ज़रूरी नहीं, स्ट्रिंग

सूचना के आइकॉन का रंग, #rrggbb फ़ॉर्मैट में दिखाया जाता है.

click_action ज़रूरी नहीं, स्ट्रिंग

सूचना पर क्लिक करने से जुड़ी उपयोगकर्ता की कार्रवाई.

अगर बताया गया है, तो मैच होने वाले इंटेंट फ़िल्टर वाली गतिविधि तब लॉन्च की जाती है, जब जब कोई उपयोगकर्ता किसी सूचना पर क्लिक करता है.

body_loc_key ज़रूरी नहीं, स्ट्रिंग

ऐप्लिकेशन के स्ट्रिंग रिसॉर्स में मौजूद बॉडी स्ट्रिंग की कुंजी का इस्तेमाल उपयोगकर्ता के मौजूदा स्थानीय भाषा के मुताबिक लेख के मुख्य हिस्से को स्थानीय भाषा में उपलब्ध कराएं.

यहां जाएं: स्ट्रिंग संसाधन देखें.

body_loc_args ज़रूरी नहीं है. JSON फ़ॉर्मैट में अरे को स्ट्रिंग के तौर पर दिखाया गया है

फ़ॉर्मैट की खास जानकारी देने वाले टूल की जगह इस्तेमाल की जाने वाली वैरिएबल स्ट्रिंग की वैल्यू लेख में मौजूद मुख्य हिस्से को स्थानीय भाषा में लिखने के लिए, body_loc_key उपयोगकर्ता के मौजूदा स्थानीय भाषा के मुताबिक होना चाहिए.

यहां जाएं: ज़्यादा जानकारी के लिए फ़ॉर्मैट और स्टाइल.

title_loc_key ज़रूरी नहीं, स्ट्रिंग

ऐप्लिकेशन के स्ट्रिंग रिसॉर्स में टाइटल स्ट्रिंग का इस्तेमाल करने के लिए उपयोगकर्ता के वर्तमान स्थानीय भाषा के अनुसार शीर्षक टेक्स्ट का स्थानीयकरण करें.

यहां जाएं: स्ट्रिंग संसाधन देखें.

title_loc_args ज़रूरी नहीं है. JSON फ़ॉर्मैट में अरे को स्ट्रिंग के तौर पर दिखाया गया है

फ़ॉर्मैट की खास जानकारी देने वाले टूल की जगह इस्तेमाल की जाने वाली वैरिएबल स्ट्रिंग की वैल्यू मूल टेक्स्ट को स्थानीय भाषा में लिखने के लिए, title_loc_key का इस्तेमाल करें उपयोगकर्ता के मौजूदा स्थानीय भाषा के मुताबिक होना चाहिए.

यहां जाएं: ज़्यादा जानकारी के लिए फ़ॉर्मैट और स्टाइल.

टेबल 2c. वेब (JavaScript) — सूचना मैसेज के लिए कुंजियां

पैरामीटर इस्तेमाल किए जाने से जुड़ी जानकारी ब्यौरा
title ज़रूरी नहीं, स्ट्रिंग

सूचना का टाइटल.

body ज़रूरी नहीं, स्ट्रिंग

सूचना का मुख्य टेक्स्ट.

icon ज़रूरी नहीं, स्ट्रिंग

सूचना के आइकॉन के लिए इस्तेमाल किया जाने वाला यूआरएल.

click_action ज़रूरी नहीं, स्ट्रिंग

सूचना पर क्लिक करने से जुड़ी उपयोगकर्ता की कार्रवाई.

यूआरएल की सभी वैल्यू के लिए, एचटीटीपीएस ज़रूरी है.

डाउनस्ट्रीम XMPP संदेश जवाब की व्याख्या करें

नीचे दी गई टेबल में उन फ़ील्ड की सूची दी गई है जो डाउनस्ट्रीम XMPP मैसेज के जवाब में दिखते हैं.

तीसरी टेबल डाउनस्ट्रीम मैसेज XMPP का जवाब.

पैरामीटर इस्तेमाल किए जाने से जुड़ी जानकारी ब्यौरा
from ज़रूरी स्ट्रिंग

इस पैरामीटर से पता चलता है कि यह जवाब किसने भेजा है.

यह वैल्यू, क्लाइंट ऐप्लिकेशन का रजिस्ट्रेशन टोकन होता है.
message_id ज़रूरी स्ट्रिंग यह पैरामीटर किसी XMPP कनेक्शन में किसी मैसेज की खास तौर पर पहचान करता है. वैल्यू एक ऐसी स्ट्रिंग है जो जुड़े हुए मैसेज की खास तौर पर पहचान करती है.
message_type ज़रूरी स्ट्रिंग

यह पैरामीटर, इनसे मिले ack या nack मैसेज के बारे में बताता है FCM को ऐप्लिकेशन सर्वर पर भेजना.

अगर वैल्यू nack पर सेट है, तो ऐप्लिकेशन सर्वर को इन्हें देखना चाहिए गड़बड़ी की जानकारी पाने के लिए, error और error_description.

error ज़रूरी नहीं, स्ट्रिंग यह पैरामीटर डाउनस्ट्रीम मैसेज से जुड़ी गड़बड़ी के बारे में बताता है. यह तब सेट होता है, जब message_type nack है. ज़्यादा जानकारी के लिए टेबल 4 देखें.
error_description ज़रूरी नहीं, स्ट्रिंग यह पैरामीटर गड़बड़ी की पूरी जानकारी देता है. यह सेट हो गया है जब message_type, nack हो.

डाउनस्ट्रीम मैसेज के गड़बड़ी के रिस्पॉन्स कोड

नीचे दी गई टेबल में डाउनस्ट्रीम मैसेज के लिए गड़बड़ी के रिस्पॉन्स कोड दिए गए हैं.

टेबल 4 डाउनस्ट्रीम मैसेज के गड़बड़ी के रिस्पॉन्स कोड.

गड़बड़ी XMPP कोड सुझाई गई कार्रवाई
रजिस्ट्रेशन टोकन मौजूद नहीं है INVALID_JSON यह देख लें कि अनुरोध में रजिस्ट्रेशन टोकन ( registration_id सादे लेख संदेश में या to में या registration_ids फ़ील्ड में कॉपी किया जा सकता है).
अमान्य एपीएन रजिस्ट्रेशन INVALID_JSON iOS रजिस्ट्रेशन के लिए, यह जांच लें कि क्लाइंट के रजिस्ट्रेशन अनुरोध में मान्य एपीएन टोकन और ऐप्लिकेशन आईडी.
अमान्य रजिस्ट्रेशन टोकन BAD_REGISTRATION उस रजिस्ट्रेशन टोकन के फ़ॉर्मैट की जांच करें जिसे आपने सर्वर को पास किया है. पक्का करें कि FCM के साथ रजिस्टर करने पर क्लाइंट ऐप्लिकेशन को मिलने वाले रजिस्ट्रेशन टोकन से मेल खाता है. ऐसा न करें काट-छांट करें या अतिरिक्त वर्ण जोड़ें.
अपंजीकृत डिवाइस DEVICE_UNREGISTERED मौजूदा रजिस्ट्रेशन टोकन, कई मामलों में मान्य नहीं रह सकता है. इनमें ये मामले शामिल हैं:
  • अगर क्लाइंट ऐप्लिकेशन, FCM के साथ रजिस्टर नहीं होता है.
  • अगर क्लाइंट ऐप्लिकेशन का रजिस्ट्रेशन अपने-आप रद्द हो जाता है, तो ऐसा तब हो सकता है, उपयोगकर्ता ऐप्लिकेशन को अनइंस्टॉल करता है. उदाहरण के लिए, iOS पर अगर एपीएन एपीएन टोकन को अमान्य के तौर पर मार्क किया गया.
  • अगर रजिस्ट्रेशन टोकन की समयसीमा खत्म हो जाती है (उदाहरण के लिए, Google, या एपीएन टोकन की समयसीमा खत्म हो गई हो.
  • अगर क्लाइंट ऐप्लिकेशन को अपडेट किया गया है, लेकिन नए वर्शन को मैसेज पाने के लिए कॉन्फ़िगर नहीं किया गया है.
ऐसे सभी मामलों के लिए, ऐप्लिकेशन से इस रजिस्ट्रेशन टोकन को हटाएं सर्वर और मैसेज भेजने के लिए इसका इस्तेमाल करना बंद कर देगा.
ईमेल भेजने वाले व्यक्ति का नाम मेल नहीं खाता SENDER_ID_MISMATCH रजिस्ट्रेशन टोकन, ईमेल भेजने वाले कुछ खास ग्रुप से जुड़ा होता है. जब कोई क्लाइंट ऐप्लिकेशन रजिस्टर होता है FCM के लिए, उसे यह निर्दिष्ट करना होगा कि किन लोगों को संदेश भेजने की अनुमति है. आपको एक का इस्तेमाल करना चाहिए क्लाइंट ऐप्लिकेशन को मैसेज भेजते समय, भेजने वाले के आईडी का इस्तेमाल करके. अगर आप किसी दूसरे भेजने वाला है, तो मौजूदा रजिस्ट्रेशन टोकन काम नहीं करेंगे.
अमान्य JSON INVALID_JSON पक्का करें कि JSON मैसेज का फ़ॉर्मैट सही हो और उसमें मान्य फ़ील्ड शामिल हों (उदाहरण के लिए, यह पक्का करना कि सही डेटा टाइप पास किया गया हो).
मैसेज बहुत बड़ा है INVALID_JSON इस बात की जांच करना कि मैसेज में शामिल पेलोड डेटा का कुल साइज़, FCM की सीमाओं से ज़्यादा नहीं होनी चाहिए: ज़्यादातर मैसेज के लिए 4096 बाइट या केस में 2048 बाइट विषयों के लिए मैसेज में से. इसमें ये दोनों चीज़ें शामिल हैं कुंजियों और मानों की जानकारी देता है.
अमान्य डेटा कुंजी INVALID_JSON देख लें कि पेलोड डेटा में कोई कुंजी (जैसे कि from, gcm या कोई भी वैल्यू google से शुरू होती है) जिसका इस्तेमाल FCM के ज़रिए अंदरूनी तौर पर किया जाता है. ध्यान दें कि कुछ शब्द (जैसे collapse_key) FCM का भी इस्तेमाल किया जाता है, लेकिन पेलोड में इनकी अनुमति है. ऐसा होने पर, पेलोड मान को FCM मान बदल दिया जाता है.
रहने का समय अमान्य है INVALID_JSON जांच लें कि time_to_live में इस्तेमाल किया गया मान अवधि 0 से 24,19,200 सेकंड के बीच (चार हफ़्ते).
खराब ACK संदेश BAD_ACK फिर से कोशिश करने से पहले, पक्का कर लें कि ack मैसेज का फ़ॉर्मैट सही है. यहां जाएं: ज़्यादा जानकारी के लिए, टेबल 6.
समय खत्म हो गया (टाइम आउट) SERVICE_UNAVAILABLE

सर्वर समय पर अनुरोध को प्रोसेस नहीं कर सका. उसी अनुरोध को फिर से करने की कोशिश करें, लेकिन आपको ये काम ज़रूर करने होंगे:

  • फिर से कोशिश करने के तरीके में एक्स्पोनेंशियल बैकऑफ़ लागू करें. (उदाहरण के लिए, अगर आपने एक सेकंड इंतज़ार किया पहले पुनर्प्रयास से पहले, अगले वाले से कम से कम दो सेकंड पहले इंतज़ार करें, फिर चार सेकंड इंतज़ार करें वगैरह). अगर आप कई मैसेज भेज रहे हैं, तो हर एक के लिए अलग-अलग देरी करें ऐसा करने पर, एक ही समय में सभी मैसेज के लिए नया अनुरोध जारी करने से बचा जा सकता है.
  • फिर से कोशिश करने के शुरुआती समय को एक सेकंड पर सेट किया जाना चाहिए.

ध्यान दें: मैसेज भेजने वाले ऐसे लोगों को ब्लैकलिस्ट किए जाने का खतरा होता है जिनकी वजह से समस्याएं होती हैं.
सर्वर में गड़बड़ी INTERNAL_SERVER_
ERROR		 आपके अनुरोध को प्रोसेस करते समय सर्वर में कोई गड़बड़ी हुई. फिर से कोशिश करें "समय खत्म" होने पर दिखने वाली ज़रूरी शर्तों के हिसाब से एक ही अनुरोध करना (ऊपर पंक्ति देखें).
डिवाइस पर मैसेज की दर पार हो गई DEVICE_MESSAGE_RATE
_EXCEEDED		 किसी खास डिवाइस पर मैसेज भेजने की दर बहुत ज़्यादा है. समस्या को हल करने के लिए, इस डिवाइस पर भेजे गए मैसेज की संख्या, कृपया इस डिवाइस पर फिर से भेजने की कोशिश न करें.
विषयों से जुड़े मैसेज की दर पार हो गई TOPICS_MESSAGE_RATE
_EXCEEDED		 किसी खास विषय पर सदस्यों को भेजे जाने वाले मैसेज की दर बहुत ज़्यादा है. समस्या को हल करने के लिए, इस विषय के लिए भेजे गए मैसेज की संख्या डालें, और तुरंत भेजने की फिर से कोशिश न करें.
कनेक्शन खत्म हो रहा है CONNECTION_DRAINING मैसेज को प्रोसेस नहीं किया जा सका, क्योंकि कनेक्शन खत्म हो रहा है. ऐसा इसलिए होता है, क्योंकि समय-समय पर, FCM को लोड बैलेंसिंग के लिए कनेक्शन बंद करना पड़ता है. मैसेज फिर से भेजने की कोशिश करें कोई अन्य XMPP कनेक्शन.
अमान्य एपीएन क्रेडेंशियल INVALID_APNS_CREDENTIAL किसी iOS डिवाइस को टारगेट किया गया मैसेज नहीं भेजा जा सका, क्योंकि इसमें ज़रूरी एपीएन शामिल हैं पुष्टि करने वाली कुंजी अपलोड नहीं हुई थी या उसकी समयसीमा खत्म हो चुकी है. अपने डेवलपमेंट की वैधता की जांच करना और प्रोडक्शन क्रेडेंशियल डालें.
प्रमाणीकरण विफल रहा AUTHENTICATION_FAILED बाहरी पुश सेवाओं से पुष्टि नहीं की जा सकी. यह जांचना कि क्या आप सही वेब पुश सर्टिफ़िकेट.

अपस्ट्रीम मैसेज सिंटैक्स

अपस्ट्रीम मैसेज, वह मैसेज होता है जिसे क्लाइंट ऐप्लिकेशन, ऐप्लिकेशन सर्वर को भेजता है. फ़िलहाल, सिर्फ़ XMPP अपस्ट्रीम मैसेजिंग के साथ काम करता है. यहां जाएं: अपने प्लैटफ़ॉर्म के दस्तावेज़ में क्लाइंट ऐप्लिकेशन से मैसेज भेजने के बारे में जानकारी.

किसी अपस्ट्रीम XMPP मैसेज की व्याख्या करना

नीचे दी गई टेबल में, जनरेट किए गए XMPP पद में फ़ील्ड के बारे में बताया गया है क्लाइंट ऐप्लिकेशन से अपस्ट्रीम मैसेज के अनुरोधों के जवाब में FCM से

पांचवीं टेबल अपस्ट्रीम XMPP मैसेज.

पैरामीटर इस्तेमाल किए जाने से जुड़ी जानकारी ब्यौरा
from ज़रूरी स्ट्रिंग

इस पैरामीटर से पता चलता है कि मैसेज किसने भेजा है.

यह वैल्यू, क्लाइंट ऐप्लिकेशन का रजिस्ट्रेशन टोकन होता है.
category ज़रूरी स्ट्रिंग यह पैरामीटर, मैसेज भेजने वाले क्लाइंट ऐप्लिकेशन के ऐप्लिकेशन पैकेज का नाम बताता है.
message_id ज़रूरी स्ट्रिंग यह पैरामीटर मैसेज का यूनीक आईडी बताता है.
data ज़रूरी नहीं, स्ट्रिंग यह पैरामीटर मैसेज के पेलोड के की-वैल्यू पेयर को तय करता है.

एक ACK संदेश भेजा जा रहा है

नीचे दी गई टेबल में उस ACK रिस्पॉन्स के बारे में बताया गया है जिसे ऐप्लिकेशन सर्वर से भेजना चाहिए FCM की मदद से ऐप्लिकेशन सर्वर को मिला अपस्ट्रीम मैसेज.

टेबल 6 अपस्ट्रीम XMPP मैसेज का जवाब.

पैरामीटर इस्तेमाल किए जाने से जुड़ी जानकारी ब्यौरा
to ज़रूरी स्ट्रिंग

इस पैरामीटर से पता चलता है कि किस व्यक्ति को जवाब भेजा गया है.

वैल्यू, उस क्लाइंट ऐप्लिकेशन का रजिस्ट्रेशन टोकन होना चाहिए जिससे अपस्ट्रीम मैसेज भेजा गया था.
message_id ज़रूरी स्ट्रिंग इस पैरामीटर से पता चलता है कि रिस्पॉन्स किस मैसेज के लिए है. मान मिलते-जुलते अपस्ट्रीम मैसेज से, message_id की वैल्यू.
message_type ज़रूरी स्ट्रिंग यह पैरामीटर किसी ऐप्लिकेशन सर्वर से सीसीएस को भेजे जाने वाले ack मैसेज के बारे में बताता है. अपस्ट्रीम मैसेज के लिए, इसे हमेशा ack पर सेट किया जाना चाहिए.

FCM सर्वर संदेश (XMPP)

यह मैसेज FCM से किसी ऐप्लिकेशन सर्वर पर भेजा गया है. FCM के लिए मुख्य रूप से भेजे जाने वाले मैसेज यहां दिए गए हैं ऐप्लिकेशन सर्वर को भेजता है:

  • कंट्रोल: सीसीएस जनरेट किए गए इन मैसेज से पता चलता है कि ऐप्लिकेशन सर्वर को कार्रवाई करनी होगी.

नीचे दी गई टेबल में, सीसीएस मैसेज में शामिल फ़ील्ड के बारे में बताया गया है किसी ऐप्लिकेशन सर्वर को भेजता है.

टेबल 7 FCM कंट्रोल मैसेज (XMPP).

पैरामीटर इस्तेमाल किए जाने से जुड़ी जानकारी ब्यौरा
सामान्य फ़ील्ड
message_type ज़रूरी स्ट्रिंग

इस पैरामीटर से पता चलता है कि मैसेज किस तरह का है: कंट्रोल.

जब इसे control पर सेट किया जाता है, तो मैसेज में control_type शामिल होता है. कंट्रोल मैसेज का टाइप.
control_type ज़रूरी नहीं, स्ट्रिंग

यह पैरामीटर FCM से भेजे गए नियंत्रण मैसेज का प्रकार तय करता है.

फ़िलहाल, सिर्फ़ CONNECTION_DRAINING का इस्तेमाल किया जा सकता है. FCM यह नियंत्रण संदेश भेजता है लोड बैलेंसिंग के लिए कनेक्शन बंद करने से पहले. कनेक्शन खत्म होने पर, कोई मैसेज नहीं दिखता कनेक्शन पर भेजने की अनुमति है, लेकिन पाइपलाइन में मौजूदा मैसेज प्रोसेस जारी रहेगी.