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 التي تم العثور عليها
nextPageToken

string

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

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

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

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

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