Method: vitals.errors.reports.search

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
parent

string

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

فرمت: apps/{app}

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

پارامترها
interval

object ( DateTimeInterval )

اختیاری. بازه زمانی تاریخ برای جستجوی گزارش‌های خطا. هر دو شروع و پایان باید با ساعت تنظیم شوند و UTC به عنوان منطقه زمانی استفاده کنند (یا خالی باشند، در این صورت UTC نیز استفاده خواهد شد).

در صورت تنظیم، فقط گزارش‌های خطایی که در بازه زمانی رخ داده‌اند، بازگردانده می‌شوند. در صورت عدم تعیین، بازه زمانی پیش‌فرض ۲۴ ساعت گذشته استفاده خواهد شد.

pageSize

integer

اختیاری. حداکثر تعداد گزارش‌هایی که باید برگردانده شود. سرویس ممکن است کمتر از این مقدار را برگرداند.

اگر مشخص نشود، حداکثر ۵۰ گزارش برگردانده می‌شود. حداکثر مقدار ۱۰۰ است؛ مقادیر بالای ۱۰۰ به ۱۰۰ کاهش می‌یابند.

pageToken

string

اختیاری. یک توکن صفحه، که از فراخوانی قبلی reports.search دریافت شده است. این را برای بازیابی صفحه بعدی ارائه دهید.

هنگام صفحه‌بندی، تمام پارامترهای دیگر ارائه شده به reports.search باید با فراخوانی که توکن صفحه را ارائه داده است، مطابقت داشته باشند.

filter

string

اختیاری. یک گزاره انتخاب برای بازیابی فقط زیرمجموعه‌ای از گزارش‌ها.

برای اصول اولیه فیلتر کردن، لطفاً AIP-160 را بررسی کنید.

**نام فیلدهای پشتیبانی شده:**

  • apiLevel : فقط گزارش‌های خطایی را که در نسخه‌های اندروید درخواستی (که به عنوان سطح 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 : فقط گزارش‌های خطایی از انواع درخواستی را مطابقت می‌دهد. گزینه‌های معتبر: CRASH ، ANR ، NON_FATAL . مثال: errorIssueType = CRASH OR errorIssueType = ANR .
  • errorIssueId : فقط گزارش‌های خطای متعلق به شناسه‌های مسئله خطای درخواستی را مطابقت می‌دهد. مثال: errorIssueId = 1234 OR errorIssueId = 4567 .
  • errorReportId : گزارش‌های خطا را با شناسه گزارش خطای درخواستی مطابقت می‌دهد. مثال: errorReportId = 1234 OR errorReportId = 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 Overview .