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 و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

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

نص الطلب

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

نص الاستجابة

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

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

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

object (ErrorIssue)

المشاكل التي تم العثور عليها
nextPageToken

string

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

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

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

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

لمزيد من المعلومات، راجِع OAuth 2.0 Overview.