- طلب HTTP
- معلمات المسار
- معلمات الاستعلام
- هيئة الطلب
- هيئة الاستجابة
- نطاقات التفويض
- AndroidDeliveryData
- تاريخ
- بيانات
- نسبة نتائج الرسالة
- نسبة أداء التسليم
- رسالة InsightPercents
- جربها!
قم بإدراج بيانات التسليم المجمعة لتطبيق Android المحدد.
طلب HTTP
GET https://fcmdata.googleapis.com/v1beta1/{parent=projects/*/androidApps/*}/deliveryData
يستخدم عنوان URL بناء جملة gRPC Transcoding .
معلمات المسار
حدود | |
---|---|
parent | مطلوب. التطبيق الذي من أجله قائمة بيانات التسليم. التنسيق: |
معلمات الاستعلام
حدود | |
---|---|
pageSize | الحد الأقصى لعدد الإدخالات للعودة. قد ترجع الخدمة أقل من هذه القيمة. إذا لم يتم التحديد، فسيتم إرجاع 1000 إدخال على الأكثر. الحد الأقصى للقيمة هو 10000؛ القيم التي تزيد عن 10000 سيتم تحديدها إلى 10000. قد يتغير هذا الافتراضي مع مرور الوقت. |
pageToken | رمز مميز للصفحة، تم استلامه من استدعاء |
هيئة الطلب
يجب أن يكون نص الطلب فارغًا.
هيئة الاستجابة
في حالة النجاح، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
رسالة الرد على DeliveryData.list.
تمثيل جيسون |
---|
{
"androidDeliveryData": [
{
object ( |
مجالات | |
---|---|
androidDeliveryData[] | بيانات التسليم للتطبيق المقدم. سيكون هناك إدخال واحد لكل مجموعة من التطبيقات والتاريخ وتسمية التحليلات. |
nextPageToken | رمز مميز يمكن إرساله كـ |
نطاقات التفويض
يتطلب نطاق OAuth التالي:
-
https://www.googleapis.com/auth/cloud-platform
AndroidDeliveryData
بيانات تسليم الرسائل لمجموعة محددة من التاريخ والتطبيق وتسمية التحليلات.
تمثيل جيسون |
---|
{ "appId": string, "date": { object ( |
مجالات | |
---|---|
appId | معرف التطبيق الذي تم إرسال الرسائل إليه. |
date | التاريخ الذي يمثله هذا الإدخال. |
analyticsLabel | تصنيف التحليلات المرتبط بالرسائل المرسلة. سيتم تجميع كافة الرسائل المرسلة بدون تصنيف تحليلات معًا في إدخال واحد. |
data | البيانات الخاصة بمعرف |
تاريخ
يمثل تاريخ تقويم كامل أو جزئي، مثل عيد ميلاد. الوقت من اليوم والمنطقة الزمنية إما محددان في مكان آخر أو غير مهمين. التاريخ نسبة إلى التقويم الغريغوري. يمكن أن يمثل هذا واحدًا مما يلي:
- تاريخ كامل، بقيم غير صفرية للسنة والشهر واليوم.
- شهر ويوم، مع سنة صفر (على سبيل المثال، ذكرى سنوية).
- سنة مستقلة بشهر صفر ويوم صفر.
- سنة وشهر، مع يوم صفر (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة الائتمان).
الأنواع ذات الصلة:
-
google.type.TimeOfDay
-
google.type.DateTime
-
google.protobuf.Timestamp
تمثيل جيسون |
---|
{ "year": integer, "month": integer, "day": integer } |
مجالات | |
---|---|
year | سنة التاريخ. يجب أن يكون من 1 إلى 9999، أو 0 لتحديد تاريخ بدون سنة. |
month | شهر من السنة. يجب أن يكون من 1 إلى 12، أو 0 لتحديد سنة بدون شهر ويوم. |
day | يوم من شهر. يجب أن يكون من 1 إلى 31 ويكون صالحًا للسنة والشهر، أو 0 لتحديد سنة بمفردها أو سنة وشهر حيث لا يكون لليوم أهمية. |
بيانات
بيانات تفصيلية لتسليم الرسائل
تمثيل جيسون |
---|
{ "countMessagesAccepted": string, "messageOutcomePercents": { object ( |
مجالات | |
---|---|
countMessagesAccepted | عدد الرسائل التي تقبلها FCM والموجهة إلى أجهزة Android. يجب أن يكون الجهاز المستهدف قد اشترك في جمع معلومات الاستخدام والتشخيص. |
messageOutcomePercents | التوزيع الحصري المتبادل لنتائج تسليم الرسائل. |
deliveryPerformancePercents | معلومات إضافية حول أداء التسليم للرسائل التي تم تسليمها بنجاح. |
messageInsightPercents | رؤى عامة إضافية حول تسليم الرسائل. |
نسبة نتائج الرسالة
النسبة المئوية لتوزيع نتائج تسليم الرسائل. هذه الفئات متنافية. يتم حساب كافة النسب المئوية باستخدام countMessagesAccepted
كمقام. قد لا تمثل هذه الفئات جميع نتائج الرسائل.
تمثيل جيسون |
---|
{ "delivered": number, "pending": number, "droppedTooManyPendingMessages": number, "droppedAppForceStopped": number, "droppedDeviceInactive": number } |
مجالات | |
---|---|
delivered | النسبة المئوية لجميع الرسائل المقبولة التي تم تسليمها بنجاح إلى الجهاز. |
pending | النسبة المئوية للرسائل المقبولة في هذا اليوم والتي لم يتم إسقاطها ولم يتم تسليمها، بسبب فصل الجهاز (اعتبارًا من نهاية يوم أمريكا/لوس_أنجلس عندما تم إرسال الرسالة إلى FCM). سيتم تسليم جزء من هذه الرسائل في اليوم التالي عندما يتصل الجهاز ولكن قد يتم توجيه البعض الآخر إلى أجهزة لن يتم إعادة الاتصال بها أبدًا. |
droppedTooManyPendingMessages | النسبة المئوية للرسائل المقبولة التي تم إسقاطها بسبب وجود عدد كبير جدًا من الرسائل غير القابلة للطي التي لم يتم تسليمها . على وجه التحديد، يمكن أن يحتوي كل مثيل تطبيق على 100 رسالة معلقة فقط مخزنة على خوادمنا لجهاز غير متصل. وعندما يعيد هذا الجهاز الاتصال، يتم تسليم هذه الرسائل. عندما يكون هناك أكثر من الحد الأقصى للرسائل المعلقة، فإننا نستدعي OnDeletedMessages() في SDK الخاص بنا بدلاً من تسليم الرسائل. |
droppedAppForceStopped | النسبة المئوية للرسائل المقبولة التي تم إسقاطها بسبب إيقاف التطبيق بالقوة على الجهاز وقت التسليم وعدم نجاح عمليات إعادة المحاولة. |
droppedDeviceInactive | النسبة المئوية للرسائل المقبولة التي تم إسقاطها لأن الجهاز المستهدف غير نشط. سوف تقوم FCM بإسقاط الرسائل إذا اعتبرت خوادمنا أن الجهاز المستهدف غير نشط. إذا تمت إعادة توصيل الجهاز، فإننا نستدعي OnDeletedMessages() في SDK الخاص بنا بدلاً من تسليم الرسائل. |
نسبة أداء التسليم
نظرة عامة على أداء التسليم للرسائل التي تم تسليمها بنجاح. يتم حساب كافة النسب المئوية باستخدام countMessagesAccepted
كمقام. هذه التصنيفات ليست مترابطه بشكل حصري؛ يمكن أن تتأخر الرسالة لأسباب متعددة.
تمثيل جيسون |
---|
{ "deliveredNoDelay": number, "delayedDeviceOffline": number, "delayedDeviceDoze": number, "delayedMessageThrottled": number, "delayedUserStopped": number } |
مجالات | |
---|---|
deliveredNoDelay | نسبة الرسائل المقبولة التي تم تسليمها للجهاز دون تأخير من نظام FCM. |
delayedDeviceOffline | النسبة المئوية للرسائل المقبولة التي تأخرت بسبب عدم اتصال الجهاز المستهدف وقت الإرسال. تم تسليم هذه الرسائل في النهاية عند إعادة توصيل الجهاز. |
delayedDeviceDoze | النسبة المئوية للرسائل المقبولة التي تم تأخيرها لأن الجهاز كان في وضع التجريف. يجب تأخير الرسائل ذات الأولوية العادية فقط بسبب وضع التجريف. |
delayedMessageThrottled | النسبة المئوية للرسائل المقبولة التي تم تأخيرها بسبب تقييد الرسائل، مثل تقييد الرسائل القابلة للطي أو تقييد الحد الأقصى لمعدل الرسائل . |
delayedUserStopped | النسبة المئوية للرسائل المقبولة التي تم تأخيرها بسبب توقف ملف تعريف مستخدم الجهاز المقصود على الجهاز المستهدف في وقت الإرسال. تم تسليم الرسائل في النهاية عند بدء تشغيل ملف تعريف المستخدم مرة أخرى. |
رسالة InsightPercents
معلومات إضافية حول تسليم الرسائل. يتم حساب كافة النسب المئوية باستخدام countMessagesAccepted
كمقام.
تمثيل جيسون |
---|
{ "priorityLowered": number } |
مجالات | |
---|---|
priorityLowered | النسبة المئوية للرسائل المقبولة التي تم تخفيض أولويتها من الأعلى إلى العادي. راجع الوثائق لتحديد أولوية الرسالة . |