Method: vitals.errors.issues.search

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

درخواست HTTP

GET https://playdeveloperreporting.googleapis.com/v1alpha1/{parent=apps/*}/errorIssues:search

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

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

پارامترها
parent

string

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

فرمت: apps/{app}

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

پارامترها
interval

object ( DateTimeInterval )

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

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

pageSize

integer

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

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

pageToken

string

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

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

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 .
  • 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 )

خطاهایی که پیدا شدند.

nextPageToken

string

توکن ادامه برای دریافت صفحه بعدی داده‌ها.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .