- HTTP अनुरोध
- पथ पैरामीटर
- क्वेरी पैरामीटर
- निकाय से अनुरोध करें
- प्रतिक्रिया निकाय
- प्राधिकरण के दायरे
- Androidडिलीवरीडेटा
- तारीख
- डेटा
- संदेश परिणाम प्रतिशत
- वितरण प्रदर्शन प्रतिशत
- MessageInsightPercents
- इसे अजमाएं!
दिए गए एंड्रॉइड एप्लिकेशन के लिए समग्र डिलीवरी डेटा सूचीबद्ध करें।
HTTP अनुरोध
GET https://fcmdata.googleapis.com/v1beta1/{parent=projects/*/androidApps/*}/deliveryData
यूआरएल जीआरपीसी ट्रांसकोडिंग सिंटैक्स का उपयोग करता है।
पथ पैरामीटर
पैरामीटर | |
---|---|
parent | आवश्यक। वह एप्लिकेशन जिसके लिए डिलीवरी डेटा सूचीबद्ध करना है. प्रारूप: |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
pageSize | वापस आने वाली प्रविष्टियों की अधिकतम संख्या. सेवा इस मान से कम रिटर्न दे सकती है. यदि अनिर्दिष्ट है, तो अधिकतम 1,000 प्रविष्टियाँ लौटा दी जाएंगी। अधिकतम मूल्य 10,000 है; 10,000 से ऊपर के मूल्यों को 10,000 तक सीमित कर दिया जाएगा। यह डिफ़ॉल्ट समय के साथ बदल सकता है. |
pageToken | पिछले |
निकाय से अनुरोध करें
अनुरोध का मुख्य भाग खाली होना चाहिए.
प्रतिक्रिया निकाय
सफल होने पर, प्रतिक्रिया निकाय में निम्नलिखित संरचना वाला डेटा शामिल होता है:
डिलीवरीडेटा.लिस्ट के लिए प्रतिक्रिया संदेश।
JSON प्रतिनिधित्व |
---|
{
"androidDeliveryData": [
{
object ( |
खेत | |
---|---|
androidDeliveryData[] | प्रदत्त ऐप के लिए डिलीवरी डेटा। ऐप, दिनांक और एनालिटिक्स लेबल के प्रत्येक संयोजन में एक प्रविष्टि होगी। |
nextPageToken | एक टोकन, जिसे अगले पेज को पुनः प्राप्त करने के लिए |
प्राधिकरण के दायरे
निम्नलिखित OAuth दायरे की आवश्यकता है:
-
https://www.googleapis.com/auth/cloud-platform
Androidडिलीवरीडेटा
किसी दी गई तारीख, ऐप और एनालिटिक्स लेबल संयोजन के लिए संदेश वितरण डेटा।
JSON प्रतिनिधित्व |
---|
{ "appId": string, "date": { object ( |
खेत | |
---|---|
appId | वह ऐप आईडी जिस पर संदेश भेजे गए थे. |
date | इस प्रविष्टि द्वारा दर्शाई गई तारीख. |
analyticsLabel | भेजे गए संदेशों से जुड़ा एनालिटिक्स लेबल। बिना एनालिटिक्स लेबल के भेजे गए सभी संदेशों को एक ही प्रविष्टि में एक साथ समूहीकृत किया जाएगा। |
data | निर्दिष्ट |
तारीख
संपूर्ण या आंशिक कैलेंडर तिथि, जैसे जन्मदिन, का प्रतिनिधित्व करता है। दिन का समय और समय क्षेत्र या तो कहीं और निर्दिष्ट हैं या महत्वहीन हैं। तिथि ग्रेगोरियन कैलेंडर के सापेक्ष है। यह निम्नलिखित में से किसी एक का प्रतिनिधित्व कर सकता है:
- गैर-शून्य वर्ष, माह और दिन मानों के साथ एक पूर्ण तिथि।
- एक महीना और दिन, शून्य वर्ष के साथ (उदाहरण के लिए, एक सालगिरह)।
- एक वर्ष अपने आप में, एक शून्य माह और एक शून्य दिन के साथ।
- एक वर्ष और महीना, शून्य दिन के साथ (उदाहरण के लिए, क्रेडिट कार्ड की समाप्ति तिथि)।
संबंधित प्रकार:
-
google.type.TimeOfDay
-
google.type.DateTime
-
google.protobuf.Timestamp
JSON प्रतिनिधित्व |
---|
{ "year": integer, "month": integer, "day": integer } |
खेत | |
---|---|
year | तिथि का वर्ष. बिना किसी वर्ष की तारीख निर्दिष्ट करने के लिए 1 से 9999 तक होना चाहिए, या 0 होना चाहिए। |
month | साल का महीना. एक महीने और दिन के बिना एक वर्ष निर्दिष्ट करने के लिए 1 से 12, या 0 होना चाहिए। |
day | एक महीने का दिन. 1 से 31 तक होना चाहिए और वर्ष और महीने के लिए मान्य होना चाहिए, या 0 स्वयं एक वर्ष निर्दिष्ट करने के लिए या एक वर्ष और महीना जहां दिन महत्वपूर्ण नहीं है। |
डेटा
डेटा विवरण संदेश वितरण
JSON प्रतिनिधित्व |
---|
{ "countMessagesAccepted": string, "messageOutcomePercents": { object ( |
खेत | |
---|---|
countMessagesAccepted | Android उपकरणों के लिए FCM द्वारा स्वीकृत संदेशों की संख्या। लक्षित डिवाइस ने उपयोग और नैदानिक जानकारी के संग्रह का विकल्प चुना होगा। |
messageOutcomePercents | संदेश वितरण परिणामों का परस्पर अनन्य विश्लेषण। |
deliveryPerformancePercents | सफलतापूर्वक वितरित किए गए संदेशों के वितरण प्रदर्शन के बारे में अतिरिक्त जानकारी। |
messageInsightPercents | संदेश वितरण के बारे में अतिरिक्त सामान्य जानकारी. |
संदेश परिणाम प्रतिशत
संदेश वितरण परिणामों का प्रतिशत विश्लेषण. ये श्रेणियाँ परस्पर अनन्य हैं। सभी प्रतिशतों की गणना हर के रूप में countMessagesAccepted
के साथ की जाती है। ये श्रेणियां सभी संदेश परिणामों को ध्यान में नहीं रख सकतीं।
JSON प्रतिनिधित्व |
---|
{ "delivered": number, "pending": number, "droppedTooManyPendingMessages": number, "droppedAppForceStopped": number, "droppedDeviceInactive": number } |
खेत | |
---|---|
delivered | सभी स्वीकृत संदेशों का प्रतिशत जो डिवाइस पर सफलतापूर्वक वितरित किए गए थे। |
pending | इस दिन स्वीकार किए गए संदेशों का प्रतिशत, जो डिवाइस के डिस्कनेक्ट होने के कारण ड्रॉप या डिलीवर नहीं किए गए थे (अमेरिका/लॉस_एंजेल्स दिन के अंत तक जब संदेश एफसीएम को भेजा गया था)। इन संदेशों का एक हिस्सा डिवाइस कनेक्ट होने पर अगले दिन वितरित किया जाएगा, लेकिन अन्य उन डिवाइसों को भेजे जा सकते हैं जो अंततः कभी दोबारा कनेक्ट नहीं होंगे। |
droppedTooManyPendingMessages | स्वीकृत संदेशों का प्रतिशत जो बहुत अधिक डिलीवर न किए गए गैर-संक्षिप्त संदेशों के कारण हटा दिए गए थे। विशेष रूप से, प्रत्येक ऐप इंस्टेंस में डिस्कनेक्ट किए गए डिवाइस के लिए हमारे सर्वर पर केवल 100 लंबित संदेश संग्रहीत हो सकते हैं। जब वह डिवाइस दोबारा कनेक्ट होता है, तो वे संदेश डिलीवर हो जाते हैं। जब अधिकतम से अधिक लंबित संदेश होते हैं, तो हम संदेश वितरित करने के बजाय अपने एसडीके में OnDeletedMessages() को कॉल करते हैं। |
droppedAppForceStopped | स्वीकार किए गए संदेशों का प्रतिशत जो इसलिए हटा दिए गए क्योंकि डिलीवरी के समय डिवाइस पर एप्लिकेशन को बलपूर्वक रोक दिया गया था और पुनः प्रयास असफल रहे थे। |
droppedDeviceInactive | स्वीकृत संदेशों का प्रतिशत जो लक्ष्य डिवाइस के निष्क्रिय होने के कारण हटा दिए गए थे। यदि लक्ष्य डिवाइस को हमारे सर्वर द्वारा निष्क्रिय माना जाता है तो एफसीएम संदेश छोड़ देगा। यदि कोई डिवाइस दोबारा कनेक्ट होता है, तो हम संदेश डिलीवर करने के बजाय अपने एसडीके में OnDeletedMessages() को कॉल करते हैं। |
वितरण प्रदर्शन प्रतिशत
सफलतापूर्वक वितरित किए गए संदेशों के वितरण प्रदर्शन का अवलोकन। सभी प्रतिशतों की गणना हर के रूप में countMessagesAccepted
के साथ की जाती है। ये श्रेणियां परस्पर अनन्य नहीं हैं; एक संदेश में कई कारणों से देरी हो सकती है।
JSON प्रतिनिधित्व |
---|
{ "deliveredNoDelay": number, "delayedDeviceOffline": number, "delayedDeviceDoze": number, "delayedMessageThrottled": number, "delayedUserStopped": number } |
खेत | |
---|---|
deliveredNoDelay | स्वीकृत संदेशों का प्रतिशत जो एफसीएम सिस्टम से बिना देरी के डिवाइस पर वितरित किए गए थे। |
delayedDeviceOffline | स्वीकृत संदेशों का प्रतिशत जो विलंबित हो गए क्योंकि भेजने के समय लक्ष्य डिवाइस कनेक्ट नहीं था। ये संदेश अंततः तब वितरित किए गए जब डिवाइस पुनः कनेक्ट हुआ। |
delayedDeviceDoze | स्वीकृत संदेशों का प्रतिशत जो विलंबित हो गए क्योंकि डिवाइस डोज़ मोड में था। केवल सामान्य प्राथमिकता वाले संदेशों को डोज़ मोड के कारण विलंबित किया जाना चाहिए। |
delayedMessageThrottled | स्वीकृत संदेशों का प्रतिशत जो संदेश थ्रॉटलिंग के कारण विलंबित हुआ, जैसे कि संक्षिप्त संदेश थ्रॉटलिंग या अधिकतम संदेश दर थ्रॉटलिंग । |
delayedUserStopped | स्वीकृत संदेशों का प्रतिशत जो विलंबित हो गए क्योंकि इच्छित डिवाइस उपयोगकर्ता-प्रोफ़ाइल को भेजे जाने के समय लक्ष्य डिवाइस पर रोक दिया गया था। संदेश अंततः तब वितरित किए गए जब उपयोगकर्ता-प्रोफ़ाइल फिर से प्रारंभ किया गया। |
MessageInsightPercents
संदेश वितरण के बारे में अतिरिक्त जानकारी. सभी प्रतिशतों की गणना हर के रूप में countMessagesAccepted
के साथ की जाती है।
JSON प्रतिनिधित्व |
---|
{ "priorityLowered": number } |
खेत | |
---|---|
priorityLowered | स्वीकृत संदेशों का प्रतिशत जिनकी प्राथमिकता उच्च से घटाकर सामान्य कर दी गई थी। संदेश प्राथमिकता निर्धारित करने के लिए दस्तावेज़ देखें। |