Method: vitals.errors.reports.search

تمام گزارش های خطای دریافتی برای یک برنامه را جستجو می کند.

درخواست HTTP

GET https://playdeveloperreporting.googleapis.com/v1beta1/{parent=apps/*}/errorReports:search

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
parent

string

ضروری. منبع اصلی گزارش ها، نشان دهنده برنامه ای است که برای آن دریافت شده است.

قالب: برنامه‌ها/{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 درخواستی (مشخص شده به عنوان سطح API عددی) رخ داده است. مثال: 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 : فقط با گزارش های خطای انواع درخواستی مطابقت دارد. نامزدهای معتبر: JAVA_CRASH ، NATIVE_CRASH ، ANR . مثال: errorIssueType = JAVA_CRASH OR errorIssueType = NATIVE_CRASH .
  • errorIssueId : گزارش های خطا را که فقط به شناسه های مشکل درخواستی مربوط می شود مطابقت می دهد. مثال: errorIssueId = 1234 OR errorIssueId = 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 مراجعه کنید.