Method: projects.androidApps.deliveryData.list

दिए गए Android ऐप्लिकेशन के लिए एग्रीगेट डिलीवरी डेटा की सूची बनाएं.

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

GET https://fcmdata.googleapis.com/v1beta1/{parent=projects/*/androidApps/*}/deliveryData

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. वह ऐप्लिकेशन जिसके लिए डिलीवरी डेटा दिखाना है. फ़ॉर्मैट: projects/{projectId}/androidApps/{appId}

क्वेरी पैरामीटर

पैरामीटर
pageSize

integer

लौटाने के लिए प्रविष्टियों की अधिकतम संख्या. सेवा इस वैल्यू से कम वैल्यू दिखा सकती है. अगर जानकारी नहीं है, तो ज़्यादा से ज़्यादा 1,000 एंट्री दिखाई जाएंगी. ज़्यादा से ज़्यादा वैल्यू 10,000 है; अगर वैल्यू 10,000 से ज़्यादा है, तो उसे 10,000 तक सीमित कर दिया जाएगा. यह डिफ़ॉल्ट स्थिति समय के साथ बदल सकती है.
pageToken

string

पिछले ListAndroidDeliveryDataRequest कॉल से मिला पेज टोकन. अगले पेज को वापस पाने के लिए, यह जानकारी दें. पेजों पर नंबर डालते समय, ListAndroidDeliveryDataRequest को दिए गए अन्य सभी पैरामीटर, पेज टोकन देने वाले कॉल से मैच होने चाहिए.

अनुरोध का मुख्य भाग

अनुरोध का लेख खाली होना चाहिए.

जवाब का लेख

deliveryData.list के लिए रिस्पॉन्स मैसेज.

अगर इंडेक्सिंग सही से हाे जाती है, ताे जवाब के लेख में नीचे दिए गए स्ट्रक्चर का डेटा शामिल होता है.

JSON के काेड में दिखाना 
{
  "androidDeliveryData": [
    {
      object (AndroidDeliveryData)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
androidDeliveryData[]

object (AndroidDeliveryData)

दिए गए ऐप्लिकेशन के लिए डिलीवरी की जानकारी. ऐप्लिकेशन, तारीख, और आंकड़ों के लेबल के हर कॉम्बिनेशन के लिए एक एंट्री होगी.
nextPageToken

string

एक टोकन, जिसे अगला पेज फिर से पाने के लिए pageToken के तौर पर भेजा जा सकता है. अगर इस फ़ील्ड को हटा दिया जाता है, तो इसके बाद कोई पेज नहीं होता.

अनुमति के दायरे

नीचे दिए गए OAuth स्कोप की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/cloud-platform

Androidडिलीवरी डेटा

किसी दी गई तारीख, ऐप्लिकेशन, और आंकड़ों के लेबल के कॉम्बिनेशन के लिए मैसेज डिलीवरी का डेटा.

JSON के काेड में दिखाना 
{
  "appId": string,
  "date": {
    object (Date)
  },
  "analyticsLabel": string,
  "data": {
    object (Data)
  }
}
फ़ील्ड
appId

string

वह ऐप्लिकेशन आईडी जिस पर मैसेज भेजे गए थे.
date

object (Date)

इस एंट्री से दिखाई जाने वाली तारीख.
analyticsLabel

string

भेजे गए मैसेज से जुड़ा ऐनलिटिक्स लेबल. बिना आंकड़ों के लेबल के भेजे गए सभी मैसेज, एक एंट्री में ग्रुप कर दिए जाएंगे.
data

object (Data)

बताए गए appId, date, और analyticsLabel के लिए डेटा.

तारीख

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

  • पूरी तारीख, जिसमें साल, महीने, और दिन की वैल्यू शून्य के अलावा किसी अन्य वैल्यू के तौर पर शामिल हों.
  • कोई महीना और दिन, जिसमें शून्य साल लिखा हो. जैसे, सालगिरह.
  • अपने आप में एक वर्ष, एक शून्य महीना और एक शून्य दिन.
  • साल और महीने, जिनमें दिन और समय शून्य हो. उदाहरण के लिए, क्रेडिट कार्ड की समयसीमा खत्म होने की तारीख.

मिलते-जुलते टाइप:

JSON के काेड में दिखाना 
{
  "year": integer,
  "month": integer,
  "day": integer
}
फ़ील्ड
year

integer

तारीख का साल. 1 से 9999 के बीच की संख्या होनी चाहिए, या बिना साल वाली तारीख को बताने के लिए 0 होना चाहिए.
month

integer

साल का महीना. यह वैल्यू 1 से 12 के बीच होनी चाहिए. अगर किसी साल में महीना और दिन नहीं है, तो उस साल की जानकारी देने के लिए यह संख्या 0 होनी चाहिए.
day

integer

महीने का दिन. इसमें 1 से 31 तक का अंतर हो सकता है. साथ ही, यह साल और महीने के लिए मान्य होना चाहिए. इसके अलावा, किसी साल के बारे में बताने के लिए, वैल्यू 0 होनी चाहिए या साल और महीने के बीच की कोई खास जानकारी नहीं होनी चाहिए.

डेटा

मैसेज डिलीवरी की सुविधा के बारे में जानकारी

JSON के काेड में दिखाना 
{
  "countMessagesAccepted": string,
  "countNotificationsAccepted": string,
  "messageOutcomePercents": {
    object (MessageOutcomePercents)
  },
  "deliveryPerformancePercents": {
    object (DeliveryPerformancePercents)
  },
  "messageInsightPercents": {
    object (MessageInsightPercents)
  },
  "proxyNotificationInsightPercents": {
    object (ProxyNotificationInsightPercents)
  }
}
फ़ील्ड
countMessagesAccepted

string (int64 format)

Android डिवाइस के लिए FCM के ज़रिए स्वीकार किए जाने वाले मैसेज की संख्या. टारगेट किए गए डिवाइस को इस्तेमाल और गड़बड़ी की जानकारी इकट्ठा करने की सुविधा के लिए ऑप्ट-इन करना होगा.
countNotificationsAccepted

string (int64 format)

Android डिवाइसों के लिए, FCM ने जिन सूचनाओं को स्वीकार किया है उनकी संख्या. टारगेट किए गए डिवाइस को इस्तेमाल और गड़बड़ी की जानकारी इकट्ठा करने की सुविधा के लिए ऑप्ट-इन करना होगा.
messageOutcomePercents

object (MessageOutcomePercents)

मैसेज डिलीवरी के नतीजों का आपस में खास ब्रेकडाउन.
deliveryPerformancePercents

object (DeliveryPerformancePercents)

डिलीवर हो चुके मैसेज की डिलीवरी की परफ़ॉर्मेंस के बारे में ज़्यादा जानकारी.
messageInsightPercents

object (MessageInsightPercents)

मैसेज डिलीवरी के बारे में ज़्यादा सामान्य जानकारी.
proxyNotificationInsightPercents

object (ProxyNotificationInsightPercents)

प्रॉक्सी सूचना डिलीवरी के बारे में ज़्यादा जानकारी.

मैसेजनतीजे के प्रतिशत

मैसेज डिलीवरी के नतीजों का प्रतिशत. ये कैटगरी अलग-अलग होती हैं. सभी प्रतिशत को डिनोमिनेटर (हर) के तौर पर countMessagesAccepted दिखाकर कैलकुलेट किया जाता है. ऐसा हो सकता है कि मैसेज के सभी नतीजों में, इन कैटगरी को शामिल न किया जाए.

JSON के काेड में दिखाना 
{
  "delivered": number,
  "pending": number,
  "collapsed": number,
  "droppedTooManyPendingMessages": number,
  "droppedAppForceStopped": number,
  "droppedDeviceInactive": number,
  "droppedTtlExpired": number
}
फ़ील्ड
delivered

number

स्वीकार किए गए उन सभी मैसेज का प्रतिशत जो डिवाइस पर डिलीवर हो गए.
pending

number

इस दिन स्वीकार किए गए उन मैसेज का प्रतिशत जो डिवाइस के डिसकनेक्ट होने की वजह से छोड़े नहीं गए और डिलीवर नहीं हुए (अमेरिका/Los_Angeles दिन के आखिर में, FCM को मैसेज भेजा गया था). डिवाइस कनेक्ट होने पर इन मैसेज का एक हिस्सा अगले दिन डिलीवर कर दिया जाएगा, लेकिन हो सकता है कि दूसरे मैसेज शायद ऐसे डिवाइसों पर मिलें जो कभी फिर से कनेक्ट न हों.
collapsed

number

स्वीकार किए गए उन मैसेज का प्रतिशत जिन्हें किसी दूसरे मैसेज ने छोटा कर दिया था.
droppedTooManyPendingMessages

number

स्वीकार किए गए उन मैसेज का प्रतिशत जिन्हें डिलीवर नहीं किए गए बहुत सारे मैसेज की वजह से हटा दिया गया था. खास तौर पर, हर ऐप्लिकेशन इंस्टेंस में हमारे सर्वर पर, डिसकनेक्ट किए गए डिवाइस के लिए सिर्फ़ 100 मैसेज सेव हो सकते हैं, जिनकी मंज़ूरी बाकी है. जब वह डिवाइस फिर से कनेक्ट होता है, तो वे मैसेज डिलीवर हो जाते हैं. अगर मैसेज की संख्या तय सीमा से ज़्यादा हो जाती है, तो हम मैसेज डिलीवर करने के बजाय, अपने SDK टूल में On DeletionMessages() को कॉल करते हैं.
droppedAppForceStopped

number

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

number

स्वीकार किए गए उन मैसेज का प्रतिशत जिन्हें टारगेट डिवाइस के बंद होने की वजह से हटाया गया था. अगर हमारे सर्वर टारगेट किए गए डिवाइस को इनऐक्टिव मान लेते हैं, तो FCM मैसेज हटा देगा. अगर कोई डिवाइस फिर से कनेक्ट होता है, तो हम मैसेज डिलीवर करने के बजाय, अपने SDK टूल में On DeletedMessages() को कॉल करते हैं.
droppedTtlExpired

number

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

DeliveryPerformancePercents

डिलीवर किए गए मैसेज की डिलीवरी की खास जानकारी. सभी प्रतिशत को डिनोमिनेटर (हर) के तौर पर countMessagesAccepted दिखाकर कैलकुलेट किया जाता है. ये कैटगरी यूनीक नहीं हैं; किसी मैसेज में कई वजहों से देरी हो सकती है.

JSON के काेड में दिखाना 
{
  "deliveredNoDelay": number,
  "delayedDeviceOffline": number,
  "delayedDeviceDoze": number,
  "delayedMessageThrottled": number,
  "delayedUserStopped": number
}
फ़ील्ड
deliveredNoDelay

number

स्वीकार किए गए उन मैसेज का प्रतिशत जो FCM सिस्टम से देरी के बिना डिवाइस पर डिलीवर किए गए.
delayedDeviceOffline

number

स्वीकार किए जाने वाले उन मैसेज का प्रतिशत जो देरी से भेजे गए, क्योंकि भेजते समय टारगेट डिवाइस कनेक्ट नहीं था. डिवाइस के फिर से कनेक्ट होने पर ये मैसेज डिलीवर हो गए.
delayedDeviceDoze

number

स्वीकार किए गए उन मैसेज का प्रतिशत जो डिवाइस के डोज़ मोड में होने की वजह से देर से आए. डोज़ मोड की वजह से, सिर्फ़ सामान्य प्राथमिकता वाले मैसेज आने में देरी होनी चाहिए.
delayedMessageThrottled

number

स्वीकार किए जाने वाले उन मैसेज का प्रतिशत जिन्हें मैसेज थ्रॉटलिंग की वजह से देर से दिखाया जा रहा था. जैसे, छोटे किए जा सकने वाले मैसेज को थ्रॉटलिंग या मैसेज की ज़्यादा से ज़्यादा दर थ्रॉटलिंग.
delayedUserStopped

number

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

MessageInsightPercents

मैसेज डिलीवरी के बारे में अतिरिक्त जानकारी. सभी प्रतिशत को डिनोमिनेटर (हर) के तौर पर countMessagesAccepted दिखाकर कैलकुलेट किया जाता है.

JSON के काेड में दिखाना 
{
  "priorityLowered": number
}
फ़ील्ड
priorityLowered

number

स्वीकार किए जाने वाले उन मैसेज का प्रतिशत जिनकी प्राथमिकता ज़्यादा से कम करके सामान्य कर दी गई थी. मैसेज की प्राथमिकता सेट करने का दस्तावेज़ देखें.

ProxyNotificationInsightPercents

प्रॉक्सी सूचना की डिलीवरी के बारे में ज़्यादा जानकारी. सभी प्रतिशत को डिनोमिनेटर (हर) के तौर पर countNotificationsAccepted की मदद से गिना जाता है.

JSON के काेड में दिखाना 
{
  "proxied": number,
  "failed": number,
  "skippedUnsupported": number,
  "skippedNotThrottled": number,
  "skippedUnconfigured": number,
  "skippedOptedOut": number
}
फ़ील्ड
proxied

number

स्वीकार की जाने वाली ऐसी सूचनाओं का प्रतिशत जिन्हें Google Play services ने प्रॉक्सी किया.
failed

number

स्वीकार की जाने वाली उन सूचनाओं का प्रतिशत जिन्हें प्रॉक्सी नहीं किया जा सका. ऐसा आम तौर पर, notifyAsPackage को कॉल करते समय होने वाले अपवादों की वजह से होता है.
skippedUnsupported

number

स्वीकार की जाने वाली उन सूचनाओं का प्रतिशत जिन्हें स्किप कर दिया गया, क्योंकि प्रॉक्सी सूचना पाने वाले के लिए यह सुविधा काम नहीं करती.
skippedNotThrottled

number

स्वीकार की जाने वाली उन सूचनाओं का प्रतिशत जिन्हें मैसेज थ्रॉटल नहीं किए जाने की वजह से स्किप कर दिया गया था.
skippedUnconfigured

number

स्वीकार की गई सूचनाओं का प्रतिशत, जिन्हें स्किप कर दिया गया, क्योंकि सूचनाओं को प्रॉक्सी करने के लिए ज़रूरी कॉन्फ़िगरेशन मौजूद नहीं हैं.
skippedOptedOut

number

स्वीकार की गई सूचनाओं का प्रतिशत, जिन्हें स्किप कर दिया गया, क्योंकि ऐप्लिकेशन ने इन मैसेज को प्रॉक्सी करने की अनुमति नहीं दी थी.