Method: vitals.errors.issues.search

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

درخواست HTTP

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

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

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

مولفه های
parent

string

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

قالب: برنامه‌ها/{app}

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

مولفه های
interval

object ( DateTimeInterval )

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

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

pageSize

integer

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

اگر نامشخص باشد، حداکثر 50 خطا برگردانده می شود. حداکثر مقدار 1000 است. مقادیر بالای 1000 به 1000 اجباری می شود.

pageToken

string

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

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

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 : فقط با مشکلات خطای انواع درخواستی مطابقت دارد. نامزدهای معتبر: 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 مراجعه کنید.