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 إدخال كحدّ أقصى. الحد الأقصى للقيمة هو 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

بيانات AndroidDeliveryData

بيانات تسليم الرسائل لمجموعة معيّنة من التاريخ والتطبيق وتصنيف الإحصاءات.

تمثيل JSON 
{
  "appId": string,
  "date": {
    object (Date)
  },
  "analyticsLabel": string,
  "data": {
    object (Data)
  }
}
الحقول
appId

string

رقم تعريف التطبيق الذي تم إرسال الرسائل إليه.
date

object (Date)

التاريخ الذي يمثله هذا الإدخال.
analyticsLabel

string

تصنيف "إحصاءات Google" المرتبط بالرسائل المُرسَلة سيتم تجميع جميع الرسائل المُرسَلة بدون تصنيف "إحصاءات 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

النسبة المئوية للرسائل المقبولة في هذا اليوم والتي لم يتم تسليمها ولم يتم تسليمها، بسبب انقطاع الاتصال في الجهاز (اعتبارًا من نهاية يوم America/Los_Angeles الذي تم إرسال الرسالة فيه إلى "المراسلة عبر السحابة الإلكترونية من 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

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

ProxyNotificationInsightPercents

معلومات إضافية حول تسليم إشعار الخادم الوكيل. ويتم احتساب جميع النسب المئوية باستخدام 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

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