Method: projects.androidApps.deliveryData.list

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

طلب HTTP

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

يستخدم عنوان URL بناء جملة gRPC Transcoding .

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

حدود
parent

string

مطلوب. التطبيق الذي من أجله قائمة بيانات التسليم. التنسيق: projects/{project_id}/androidApps/{appId}

معلمات الاستعلام

حدود
pageSize

integer

الحد الأقصى لعدد الإدخالات للعودة. قد ترجع الخدمة أقل من هذه القيمة. إذا لم يتم التحديد، فسيتم إرجاع 1000 إدخال على الأكثر. الحد الأقصى للقيمة هو 10000؛ القيم التي تزيد عن 10000 سيتم تحديدها إلى 10000. قد يتغير هذا الافتراضي مع مرور الوقت.

pageToken

string

رمز مميز للصفحة، تم استلامه من استدعاء ListAndroidDeliveryDataRequest سابق. قم بتوفير هذا لاسترداد الصفحة التالية. عند ترقيم الصفحات، يجب أن تتطابق جميع المعلمات الأخرى المقدمة إلى ListAndroidDeliveryDataRequest مع الاستدعاء الذي قدم الرمز المميز للصفحة.

هيئة الطلب

يجب أن يكون نص الطلب فارغًا.

هيئة الاستجابة

في حالة النجاح، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

رسالة الرد على DeliveryData.list.

تمثيل جيسون
{
  "androidDeliveryData": [
    {
      object (AndroidDeliveryData)
    }
  ],
  "nextPageToken": string
}
مجالات
androidDeliveryData[]

object ( AndroidDeliveryData )

بيانات التسليم للتطبيق المقدم. سيكون هناك إدخال واحد لكل مجموعة من التطبيقات والتاريخ وتسمية التحليلات.

nextPageToken

string

رمز مميز يمكن إرساله كـ pageToken لاسترداد الصفحة التالية. إذا تم حذف هذا الحقل، فلن تكون هناك صفحات لاحقة.

نطاقات التفويض

يتطلب نطاق OAuth التالي:

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

AndroidDeliveryData

بيانات تسليم الرسائل لمجموعة محددة من التاريخ والتطبيق وتسمية التحليلات.

تمثيل جيسون
{
  "appId": string,
  "date": {
    object (Date)
  },
  "analyticsLabel": string,
  "data": {
    object (Data)
  }
}
مجالات
appId

string

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

date

object ( Date )

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

analyticsLabel

string

تصنيف التحليلات المرتبط بالرسائل المرسلة. سيتم تجميع كافة الرسائل المرسلة بدون تصنيف تحليلات معًا في إدخال واحد.

data

object ( Data )

البيانات الخاصة بمعرف appId date وتسمية analyticsLabel المحددة.

تاريخ

يمثل تاريخ تقويم كامل أو جزئي، مثل عيد ميلاد. الوقت من اليوم والمنطقة الزمنية إما محددان في مكان آخر أو غير مهمين. التاريخ نسبة إلى التقويم الغريغوري. يمكن أن يمثل هذا واحدًا مما يلي:

  • تاريخ كامل، بقيم غير صفرية للسنة والشهر واليوم.
  • شهر ويوم، مع سنة صفر (على سبيل المثال، ذكرى سنوية).
  • سنة مستقلة بشهر صفر ويوم صفر.
  • سنة وشهر، مع يوم صفر (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة الائتمان).

الأنواع ذات الصلة:

تمثيل جيسون
{
  "year": integer,
  "month": integer,
  "day": integer
}
مجالات
year

integer

سنة التاريخ. يجب أن يكون من 1 إلى 9999، أو 0 لتحديد تاريخ بدون سنة.

month

integer

شهر من السنة. يجب أن يكون من 1 إلى 12، أو 0 لتحديد سنة بدون شهر ويوم.

day

integer

يوم من شهر. يجب أن يكون من 1 إلى 31 ويكون صالحًا للسنة والشهر، أو 0 لتحديد سنة بمفردها أو سنة وشهر حيث لا يكون لليوم أهمية.

بيانات

بيانات تفصيلية لتسليم الرسائل

تمثيل جيسون
{
  "countMessagesAccepted": string,
  "messageOutcomePercents": {
    object (MessageOutcomePercents)
  },
  "deliveryPerformancePercents": {
    object (DeliveryPerformancePercents)
  },
  "messageInsightPercents": {
    object (MessageInsightPercents)
  }
}
مجالات
countMessagesAccepted

string ( int64 format)

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

messageOutcomePercents

object ( MessageOutcomePercents )

التوزيع الحصري المتبادل لنتائج تسليم الرسائل.

deliveryPerformancePercents

object ( DeliveryPerformancePercents )

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

messageInsightPercents

object ( MessageInsightPercents )

رؤى عامة إضافية حول تسليم الرسائل.

نسبة نتائج الرسالة

النسبة المئوية لتوزيع نتائج تسليم الرسائل. هذه الفئات متنافية. يتم حساب كافة النسب المئوية باستخدام countMessagesAccepted كمقام. قد لا تمثل هذه الفئات جميع نتائج الرسائل.

تمثيل جيسون
{
  "delivered": number,
  "pending": number,
  "droppedTooManyPendingMessages": number,
  "droppedAppForceStopped": number,
  "droppedDeviceInactive": number
}
مجالات
delivered

number

النسبة المئوية لجميع الرسائل المقبولة التي تم تسليمها بنجاح إلى الجهاز.

pending

number

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

droppedTooManyPendingMessages

number

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

droppedAppForceStopped

number

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

droppedDeviceInactive

number

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

نسبة أداء التسليم

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

تمثيل جيسون
{
  "deliveredNoDelay": number,
  "delayedDeviceOffline": number,
  "delayedDeviceDoze": number,
  "delayedMessageThrottled": number,
  "delayedUserStopped": number
}
مجالات
deliveredNoDelay

number

نسبة الرسائل المقبولة التي تم تسليمها للجهاز دون تأخير من نظام FCM.

delayedDeviceOffline

number

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

delayedDeviceDoze

number

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

delayedMessageThrottled

number

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

delayedUserStopped

number

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

رسالة InsightPercents

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

تمثيل جيسون
{
  "priorityLowered": number
}
مجالات
priorityLowered

number

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