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: تطابق تقارير الأخطاء من الأنواع المطلوبة فقط. القيم الصالحة: CRASH وANR وNON_FATAL مثال: errorIssueType = CRASH OR errorIssueType = ANR
  • ‫errorIssueId: تطابق تقارير الأخطاء التي تنتمي إلى أرقام تعريف مشاكل الأخطاء المطلوبة فقط. مثال: errorIssueId = 1234 OR errorIssueId = 4567
  • errorReportId: تطابق تقارير الأخطاء مع رقم تعريف تقرير الخطأ المطلوب. مثال: errorReportId = 1234 OR errorReportId = 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 Overview.