Method: vitals.errors.reports.search

يبحث هذا المعامل في جميع تقارير الأخطاء التي تلقّتها أحد التطبيقات.

طلب HTTP

GET https://playdeveloperreporting.googleapis.com/v1beta1/{parent=apps/*}/errorReports:search

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

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

المَعلمات
parent

string

مطلوبة. المورد الرئيسي للتقارير، والذي يشير إلى التطبيق الذي تم استلامها من أجله.

التنسيق: apps/{app}

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

المَعلمات
interval

object (DateTimeInterval)

الفاصل الزمني بين التاريخ والوقت للبحث في تقارير الأخطاء. يجب محاذاة كل من البداية والنهاية مع الوقت واستخدام UTC كمنطقة زمنية (أو أن يكون الحقل فارغًا، وفي هذه الحالة سيتم استخدام UTC أيضًا).

وفي حال ضبطها، سيتم عرض تقارير الأخطاء التي حدثت خلال الفترة الزمنية فقط. وفي حال عدم تحديد هذا الحقل، سيتم استخدام الفاصل الزمني التلقائي لآخر 24 ساعة.

pageSize

integer

الحد الأقصى لعدد التقارير المطلوب عرضها. وقد تعرِض الخدمة قيمة أقل من هذه القيمة.

وفي حال عدم تحديد هذا الحقل، سيتم عرض 50 تقريرًا على الأكثر. الحد الأقصى للقيمة هو 100، وسيتم فرض القيم التي تزيد عن 100 لتصبح 100.

pageToken

string

رمز مميّز للصفحة تم تلقّيه من مكالمة سابقة لـ reports.search. قم بإدخاله لاسترداد الصفحة التالية.

عند تقسيم النتائج على عدّة صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى reports.search مع الطلب الذي قدَّم الرمز المميّز للصفحة.

filter

string

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

لمعرفة أساسيات الفلترة، يُرجى اختيار AIP-160.

** أسماء الحقول المسموح بها:**

  • apiLevel: تتطابق مع تقارير الأخطاء التي حدثت في إصدارات Android المطلوبة (المحددة على أنها مستوى واجهة برمجة التطبيقات الرقمي) فقط. مثال: apiLevel = 28 OR apiLevel = 29
  • versionCode: يطابق تقارير الأخطاء التي حدثت في رموز إصدارات التطبيق المطلوبة فقط. مثال: versionCode = 123 OR versionCode = 456
  • deviceModel: يطابق مشاكل الأخطاء التي حدثت في الأجهزة المطلوبة. مثال: deviceModel = "google/walleye" OR deviceModel = "google/marlin"
  • deviceBrand: يطابق مشاكل الخطأ التي حدثت في العلامات التجارية المطلوبة للأجهزة. مثال: "deviceBrand = "Google".
  • deviceType: يطابق تقارير الأخطاء التي حدثت في أنواع الأجهزة المطلوبة. مثال: deviceType = "PHONE"
  • errorIssueType: يطابق تقارير الأخطاء للأنواع المطلوبة فقط. العناصر المرشحة الصالحة: JAVA_CRASH، NATIVE_CRASH، ANR. مثال: errorIssueType = JAVA_CRASH OR errorIssueType = NATIVE_CRASH
  • errorIssueId: يطابق تقارير الأخطاء التي تنتمي إلى أرقام تعريف مشاكل الأخطاء المطلوبة فقط. مثال: errorIssueId = 1234 OR errorIssueId = 4567
  • appProcessState: يطابق تقارير الأخطاء في حالة معالجة تطبيق، للإشارة إلى ما إذا كان التطبيق يعمل في المقدّمة (مرئي للمستخدم) أو في الخلفية. المرشّحون الصالحون: FOREGROUND وBACKGROUND. مثال: appProcessState = FOREGROUND
  • isUserPerceived: يطابق تقارير الأخطاء التي لاحظها المستخدمون. ولا يرافقها أي عوامل تشغيل. مثال: isUserPerceived

** عوامل التشغيل المتوافقة:**

  • عوامل المقارنة: عامل المقارنة الوحيد المتاح هو المساواة. يجب أن يظهر الحقل المفلتر على الجانب الأيمن من المقارنة.
  • عوامل التشغيل المنطقية: يمكن استخدام العاملَين المنطقيَين AND وOR لإنشاء فلاتر معقّدة وفقًا لنموذج الاقتران العادي (CNF)، أي فاصلات فاصلة. للعامل OR الأولوية على AND ولذلك ليس من الضروري استخدام الأقواس عند إنشاء CNF.

لا يمكن استخدام عامل التشغيل OR إلا لإنشاء فاصلات تنطبق على الحقل نفسه، مثل versionCode = 123 OR versionCode = ANR. تعبير الفلتر versionCode = 123 OR errorIssueType = ANR غير صالح.

** أمثلة **

بعض تعبيرات الفلترة الصالحة: * versionCode = 123 AND errorIssueType = ANR * versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH * versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)

نص الطلب

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

نص الاستجابة

ردّ يتضمّن قائمة بتقارير أخطاء مقسّمة على صفحات تتطابق مع طلب البحث

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

تمثيل JSON
{
  "errorReports": [
    {
      object (ErrorReport)
    }
  ],
  "nextPageToken": string
}
الحقول
errorReports[]

object (ErrorReport)

تم العثور على تقارير الأخطاء.

nextPageToken

string

الرمز المميز للصفحة لجلب الصفحة التالية من التقارير

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

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/playdeveloperreporting

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.