Method: vitals.errors.issues.search

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

طلب HTTP

GET https://playdeveloperreporting.googleapis.com/v1beta1/{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. مثال: 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

ملاحظة: يتوفّر حاليًا حقل واحد فقط في كل مرة.

نص الطلب

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

نص الاستجابة

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

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

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

object (ErrorIssue)

مشكلات الأخطاء التي تم العثور عليها.

nextPageToken

string

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

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

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

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

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