Method: vitals.errors.issues.search

يبحث عن جميع مشاكل الأخطاء التي تم تجميع التقارير فيها.

طلب HTTP

GET https://playdeveloperreporting.googleapis.com/v1alpha1/{parent=apps/*}/errorIssues:search

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

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

المعلمات
parent

string

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

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

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

المعلمات
interval

object (DateTimeInterval)

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

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

integer

اختياريّ. تمثّل هذه السمة الحدّ الأقصى لعدد المشاكل التي تتضمّن أخطاء والتي سيتم عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة.

إذا لم يتم تحديدها، سيتم عرض 50 مشكلة خطأ على الأكثر. الحد الأقصى للقيمة هو 1000، وسيتم فرض القيمة 1000 على القيم الأعلى من 1000.
pageToken

string

اختياريّ. رمز مميّز للصفحة تم استلامه من طلب سابق. يجب تقديم هذا الرمز لاسترداد الصفحة التالية.

عند تقسيم النتائج إلى صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة في الطلب مع الطلب الذي قدّم رمز الصفحة.
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.
  • ‫appProcessState: تطابِق مشاكل الأخطاء في حالة عملية أحد التطبيقات، ما يشير إلى ما إذا كان التطبيق يعمل في المقدّمة (مرئيًا للمستخدم) أو في الخلفية. القيم الصالحة: FOREGROUND وBACKGROUND. مثال: appProcessState = FOREGROUND.
  • ‫isUserPerceived: تطابق مشاكل الأخطاء التي لاحظها المستخدمون. ولا يرافقه أي عوامل تشغيل. مثال: isUserPerceived.

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

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

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

** أمثلة **

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

string

اختياريّ. تحدّد هذه السمة حقلاً سيتم استخدامه لترتيب النتائج.

** السمات المتوافقة:**

  • errorReportCount: ترتيب المشاكل حسب عدد تقارير الأخطاء
  • distinctUsers: ترتيب المشاكل حسب عدد المستخدمين الفريدين المتأثرين بها

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

  • asc للترتيب تصاعديًا
  • desc للترتيب التنازلي

التنسيق: حقل وعملية، مثل errorReportCount desc

ملاحظة: لا يمكن استخدام سوى حقل واحد في كل مرة.
sampleErrorReportLimit

integer

اختياريّ. عدد تقارير الأخطاء النموذجية التي سيتم عرضها لكل ErrorIssue. في حال عدم تحديدها، سيتم استخدام القيمة 0. ملاحظة: لا تتوفّر حاليًا سوى القيمتَين 0 و1.

نص الطلب

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

نص الاستجابة

ردّ يتضمّن قائمة مقسّمة إلى صفحات بالمشاكل التي تطابقت مع الطلب

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

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

object (ErrorIssue)

ErrorIssues that were found.
nextPageToken

string

رمز مميز للمتابعة من أجل جلب الصفحة التالية من البيانات.

نطاقات الأذونات

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

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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.