Method: projects.androidApps.deliveryData.list

سرد بيانات التسليم المجمّعة لتطبيق Android المحدّد

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
parent

string

مطلوب. التطبيق الذي يتم إدراج بيانات التسليم له. تنسيق الملف: projects/{projectId}/androidApps/{appId}

معامِلات طلب البحث

المَعلمات
pageSize

integer

الحد الأقصى لعدد الإدخالات المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. في حال عدم تحديد قيمة هذه السمة، سيتم عرض 1,000 إدخال كحدّ أقصى. الحد الأقصى للقيمة هو 10000؛ فسيتم تحديد القيم التي تزيد عن 10000 إلى 10000. وقد يتغيّر هذا الخيار التلقائي بمرور الوقت.

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

تصنيف الإحصاءات المرتبط بالرسائل المُرسَلة سيتم تجميع جميع الرسائل المُرسَلة بدون تصنيف "إحصاءات Google" معًا في إدخال واحد.

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)

عدد الرسائل التي تقبلها ميزة "المراسلة عبر السحابة الإلكترونية من Firebase" والمخصّصة لأجهزة Android. يجب أن يكون الجهاز المستهدَف قد وافق على جمع معلومات الاستخدام والتشخيص.

countNotificationsAccepted

string (int64 format)

عدد الإشعارات التي وافقت عليها خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" والمخصّصة لأجهزة Android. يجب أن يكون الجهاز المستهدَف قد وافق على جمع معلومات الاستخدام والتشخيص.

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

النسبة المئوية للرسائل المقبولة في هذا اليوم والتي لم يتم تسليمها ولم يتم تسليمها، بسبب انقطاع اتصال الجهاز (اعتبارًا من نهاية يوم أمريكا/لوس أنجلوس عندما تم إرسال الرسالة إلى خدمة "المراسلة عبر السحابة الإلكترونية من Firebase"). وسيتم تسليم جزء من هذه الرسائل في اليوم التالي عند اتصال الجهاز، ولكن قد يتم توجيه الرسائل الأخرى إلى أجهزة لا تتصل مطلقًا.

collapsed

number

النسبة المئوية للرسائل المقبولة التي تم تصغيرها بسبب رسالة أخرى.

droppedTooManyPendingMessages

number

النسبة المئوية للرسائل المقبولة التي تم تجاهلها بسبب عدد كبير جدًا من الرسائل غير القابلة للتصغير التي لم يتم تسليمها. وعلى وجه التحديد، لا يمكن أن يحتوي كل مثيل تطبيق إلا على 100 رسالة معلّقة مخزنة على خوادمنا لجهاز غير متصل. وعند إعادة اتصال هذا الجهاز، يتم تسليم هذه الرسائل. وعندما يتجاوز عدد الرسائل في انتظار المراجعة الحد الأقصى المسموح به، يتم استدعاء OnDeletedMessages() في حزمة SDK بدلاً من تسليم الرسائل.

droppedAppForceStopped

number

النسبة المئوية للرسائل المقبولة التي تم تجاهلها بسبب فرض إيقاف التطبيق على الجهاز في وقت التسليم وتعذُّر إعادة المحاولة.

droppedDeviceInactive

number

النسبة المئوية للرسائل المقبولة التي تم تجاهلها لأنّ الجهاز المستهدَف غير نشط. ستتجاهل خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" الرسائل إذا اعتبرت خوادمنا الجهاز المستهدَف غير نشط. في حال أعاد الجهاز الاتصال بالإنترنت، نسمي OnDeletedMessages() في حزمة SDK بدلاً من تسليم الرسائل.

droppedTtlExpired

number

النسبة المئوية للرسائل المقبولة التي انتهت صلاحيتها بسبب انقضاء مدة البقاء (TTL) قبل إعادة توصيل الجهاز الهدف.

النسب المئوية لأداء عرض الإعلانات

نظرة عامة على أداء التسليم للرسائل التي تم تسليمها بنجاح. يتم حساب جميع النسب المئوية باستخدام countMessagesAccepted باعتباره المقام. هذه الفئات ليست مقتصرة على كل فئة منهما. يمكن أن تتأخر رسالة لأسباب متعددة.

تمثيل JSON
{
  "deliveredNoDelay": number,
  "delayedDeviceOffline": number,
  "delayedDeviceDoze": number,
  "delayedMessageThrottled": number,
  "delayedUserStopped": number
}
الحقول
deliveredNoDelay

number

النسبة المئوية للرسائل المقبولة التي تم تسليمها إلى الجهاز بدون تأخير من نظام المراسلة عبر السحابة الإلكترونية من Firebase.

delayedDeviceOffline

number

النسبة المئوية للرسائل المقبولة التي تأخّرت بسبب عدم اتصال الجهاز المستهدف في وقت الإرسال. وتم تسليم هذه الرسائل في النهاية عند إعادة توصيل الجهاز.

delayedDeviceDoze

number

النسبة المئوية للرسائل المقبولة التي تأخرت بسبب أن الجهاز كان في وضع القيلولة. يجب أن تتأخر الرسائل ذات الأولوية العادية فقط بسبب وضع القيلولة.

delayedMessageThrottled

number

النسبة المئوية للرسائل المقبولة التي تأخرت بسبب تقييد الرسائل، مثل تقييد الرسائل القابلة للتصغير أو تقييد الحدّ الأقصى لمعدّل الرسائل

delayedUserStopped

number

النسبة المئوية للرسائل المقبولة التي تأخّرت بسبب إيقاف الملف الشخصي للمستخدم المقصود على الجهاز المستهدف في وقت الإرسال. تم تسليم الرسائل في النهاية عند بدء الملف الشخصي للمستخدم مرة أخرى.

نسبة إحصاءات الرسائل

معلومات إضافية عن تسليم الرسائل يتم حساب جميع النسب المئوية باستخدام countMessagesAccepted باعتباره المقام.

تمثيل JSON
{
  "priorityLowered": number
}
الحقول
priorityLowered

number

النسبة المئوية للرسائل المقبولة التي انخفضت أولويتها من عالية إلى عادية. راجِع مستندات إعداد أولوية الرسالة.

ProxyNotificationInsight%s

معلومات إضافية حول تسليم إشعار الخادم الوكيل يتم حساب جميع النسب المئوية باستخدام countNotificationsAccepted باعتباره المقام.

تمثيل JSON
{
  "proxied": number,
  "failed": number,
  "skippedUnsupported": number,
  "skippedNotThrottled": number,
  "skippedUnconfigured": number,
  "skippedOptedOut": number
}
الحقول
proxied

number

النسبة المئوية للإشعارات المقبولة التي تم إنشاء خادم وكيل لها بنجاح من خلال خدمات Google Play.

failed

number

النسبة المئوية للإشعارات التي تم قبولها والتي تعذّر إنشاء خادم وكيل لها. يحدث هذا عادةً بسبب الاستثناءات التي حدثت أثناء استدعاء notifyAsPackage.

skippedUnsupported

number

النسبة المئوية للإشعارات المقبولة التي تم تخطّيها لأن إشعار الخادم الوكيل غير متوافق مع المستلِم.

skippedNotThrottled

number

النسبة المئوية للإشعارات المقبولة التي تم تخطّيها بسبب عدم تقييد الرسائل.

skippedUnconfigured

number

النسبة المئوية للإشعارات المقبولة التي تم تخطّيها بسبب عدم توفُّر الإعدادات المطلوبة لإنشاء خادم وكيل للإشعارات.

skippedOptedOut

number

النسبة المئوية للإشعارات المقبولة التي تم تخطّيها لأنّ التطبيق لم يسمح باستخدام خادم وكيل لهذه الرسائل.