Method: projects.androidApps.deliveryData.list

दिए गए एंड्रॉइड एप्लिकेशन के लिए समग्र डिलीवरी डेटा सूचीबद्ध करें।

HTTP अनुरोध

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

यूआरएल जीआरपीसी ट्रांसकोडिंग सिंटैक्स का उपयोग करता है।

पथ पैरामीटर

पैरामीटर
parent

string

आवश्यक। वह एप्लिकेशन जिसके लिए डिलीवरी डेटा सूचीबद्ध करना है. प्रारूप: projects/{project_id}/androidApps/{appId}

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

पैरामीटर
pageSize

integer

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

pageToken

string

पिछले ListAndroidDeliveryDataRequest कॉल से प्राप्त एक पेज टोकन। अगले पृष्ठ को पुनः प्राप्त करने के लिए इसे प्रदान करें। पेजिनेट करते समय, ListAndroidDeliveryDataRequest को प्रदान किए गए अन्य सभी पैरामीटर उस कॉल से मेल खाने चाहिए जो पेज टोकन प्रदान करता है।

निकाय से अनुरोध करें

अनुरोध का मुख्य भाग खाली होना चाहिए.

प्रतिक्रिया निकाय

सफल होने पर, प्रतिक्रिया निकाय में निम्नलिखित संरचना वाला डेटा शामिल होता है:

डिलीवरीडेटा.लिस्ट के लिए प्रतिक्रिया संदेश।

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,
  "messageOutcomePercents": {
    object (MessageOutcomePercents)
  },
  "deliveryPerformancePercents": {
    object (DeliveryPerformancePercents)
  },
  "messageInsightPercents": {
    object (MessageInsightPercents)
  }
}
खेत
countMessagesAccepted

string ( int64 format)

Android उपकरणों के लिए FCM द्वारा स्वीकृत संदेशों की संख्या। लक्षित डिवाइस ने उपयोग और नैदानिक ​​जानकारी के संग्रह का विकल्प चुना होगा।

messageOutcomePercents

object ( MessageOutcomePercents )

संदेश वितरण परिणामों का परस्पर अनन्य विश्लेषण।

deliveryPerformancePercents

object ( DeliveryPerformancePercents )

सफलतापूर्वक वितरित किए गए संदेशों के वितरण प्रदर्शन के बारे में अतिरिक्त जानकारी।

messageInsightPercents

object ( MessageInsightPercents )

संदेश वितरण के बारे में अतिरिक्त सामान्य जानकारी.

संदेश परिणाम प्रतिशत

संदेश वितरण परिणामों का प्रतिशत विश्लेषण. ये श्रेणियाँ परस्पर अनन्य हैं। सभी प्रतिशतों की गणना हर के रूप में countMessagesAccepted के साथ की जाती है। ये श्रेणियां सभी संदेश परिणामों को ध्यान में नहीं रख सकतीं।

JSON प्रतिनिधित्व
{
  "delivered": number,
  "pending": number,
  "droppedTooManyPendingMessages": number,
  "droppedAppForceStopped": number,
  "droppedDeviceInactive": number
}
खेत
delivered

number

सभी स्वीकृत संदेशों का प्रतिशत जो डिवाइस पर सफलतापूर्वक वितरित किए गए थे।

pending

number

इस दिन स्वीकार किए गए संदेशों का प्रतिशत, जो डिवाइस के डिस्कनेक्ट होने के कारण ड्रॉप या डिलीवर नहीं किए गए थे (अमेरिका/लॉस_एंजेल्स दिन के अंत तक जब संदेश एफसीएम को भेजा गया था)। इन संदेशों का एक हिस्सा डिवाइस कनेक्ट होने पर अगले दिन वितरित किया जाएगा, लेकिन अन्य उन डिवाइसों को भेजे जा सकते हैं जो अंततः कभी दोबारा कनेक्ट नहीं होंगे।

droppedTooManyPendingMessages

number

स्वीकृत संदेशों का प्रतिशत जो बहुत अधिक डिलीवर न किए गए गैर-संक्षिप्त संदेशों के कारण हटा दिए गए थे। विशेष रूप से, प्रत्येक ऐप इंस्टेंस में डिस्कनेक्ट किए गए डिवाइस के लिए हमारे सर्वर पर केवल 100 लंबित संदेश संग्रहीत हो सकते हैं। जब वह डिवाइस दोबारा कनेक्ट होता है, तो वे संदेश डिलीवर हो जाते हैं। जब अधिकतम से अधिक लंबित संदेश होते हैं, तो हम संदेश वितरित करने के बजाय अपने एसडीके में OnDeletedMessages() को कॉल करते हैं।

droppedAppForceStopped

number

स्वीकार किए गए संदेशों का प्रतिशत जो इसलिए हटा दिए गए क्योंकि डिलीवरी के समय डिवाइस पर एप्लिकेशन को बलपूर्वक रोक दिया गया था और पुनः प्रयास असफल रहे थे।

droppedDeviceInactive

number

स्वीकृत संदेशों का प्रतिशत जो लक्ष्य डिवाइस के निष्क्रिय होने के कारण हटा दिए गए थे। यदि लक्ष्य डिवाइस को हमारे सर्वर द्वारा निष्क्रिय माना जाता है तो एफसीएम संदेश छोड़ देगा। यदि कोई डिवाइस दोबारा कनेक्ट होता है, तो हम संदेश डिलीवर करने के बजाय अपने एसडीके में OnDeletedMessages() को कॉल करते हैं।

वितरण प्रदर्शन प्रतिशत

सफलतापूर्वक वितरित किए गए संदेशों के वितरण प्रदर्शन का अवलोकन। सभी प्रतिशतों की गणना हर के रूप में countMessagesAccepted के साथ की जाती है। ये श्रेणियां परस्पर अनन्य नहीं हैं; एक संदेश में कई कारणों से देरी हो सकती है।

JSON प्रतिनिधित्व
{
  "deliveredNoDelay": number,
  "delayedDeviceOffline": number,
  "delayedDeviceDoze": number,
  "delayedMessageThrottled": number,
  "delayedUserStopped": number
}
खेत
deliveredNoDelay

number

स्वीकृत संदेशों का प्रतिशत जो एफसीएम सिस्टम से बिना देरी के डिवाइस पर वितरित किए गए थे।

delayedDeviceOffline

number

स्वीकृत संदेशों का प्रतिशत जो विलंबित हो गए क्योंकि भेजने के समय लक्ष्य डिवाइस कनेक्ट नहीं था। ये संदेश अंततः तब वितरित किए गए जब डिवाइस पुनः कनेक्ट हुआ।

delayedDeviceDoze

number

स्वीकृत संदेशों का प्रतिशत जो विलंबित हो गए क्योंकि डिवाइस डोज़ मोड में था। केवल सामान्य प्राथमिकता वाले संदेशों को डोज़ मोड के कारण विलंबित किया जाना चाहिए।

delayedMessageThrottled

number

स्वीकृत संदेशों का प्रतिशत जो संदेश थ्रॉटलिंग के कारण विलंबित हुआ, जैसे कि संक्षिप्त संदेश थ्रॉटलिंग या अधिकतम संदेश दर थ्रॉटलिंग

delayedUserStopped

number

स्वीकृत संदेशों का प्रतिशत जो विलंबित हो गए क्योंकि इच्छित डिवाइस उपयोगकर्ता-प्रोफ़ाइल को भेजे जाने के समय लक्ष्य डिवाइस पर रोक दिया गया था। संदेश अंततः तब वितरित किए गए जब उपयोगकर्ता-प्रोफ़ाइल फिर से प्रारंभ किया गया।

MessageInsightPercents

संदेश वितरण के बारे में अतिरिक्त जानकारी. सभी प्रतिशतों की गणना हर के रूप में countMessagesAccepted के साथ की जाती है।

JSON प्रतिनिधित्व
{
  "priorityLowered": number
}
खेत
priorityLowered

number

स्वीकृत संदेशों का प्रतिशत जिनकी प्राथमिकता उच्च से घटाकर सामान्य कर दी गई थी। संदेश प्राथमिकता निर्धारित करने के लिए दस्तावेज़ देखें।