Method: vitals.errors.counts.query

سنجه‌ها را در مجموعه سنجه‌ها پُرسمان می‌کند.

درخواست HTTP

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/errorCountMetricSet}:query

نشانی وب از نحو تراتبدیل gRPC استفاده می‌کند.

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

پارامترها
name

string

الزامی. نام منبع.

قالب: apps/{app}/errorCountMetricSet

متن درخواست

بدنه درخواست حاوی داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "pageSize": integer,
  "pageToken": string,
  "filter": string
}
فیلدها
timelineSpec

object (TimelineSpec)

اختیاری. مشخصات پارامترهای تجمیع خط زمان.

دوره‌های انبوهش پشتیبانی‌شده:

  • DAILY: سنجه‌ها در فواصل تاریخ تقویم تجمیع می‌شوند. منطقه زمانی پیش‌فرض و تنها منطقه زمانی پشتیبانی‌شده America/Los_Angeles است.
dimensions[]

string

اختیاری. ابعادی که داده‌ها براساس آن‌ها تقسیم می‌شود.

ابعاد پشتیبانی‌شده:

  • apiLevel (string): سطح میانای برنامه‌سازی کاربردی Android که در دستگاه کاربر درحال اجرا بود، برای مثال، ۲۶.
  • versionCode (int64): شناسه یکتای مدل دستگاه کاربر. قالب شناسه به‌صورت «deviceBrand/device» است که در آن deviceBrand با Build.BRAND و device با Build.DEVICE مطابقت دارد، مثلاً google/coral.
  • deviceModel (string): شناسه یکتای مدل دستگاه کاربر.
  • deviceType (string): شناسه ضریب شکل دستگاه، مثلاً PHONE.
  • reportType (string): نوع خطا. مقدار باید با یکی از مقادیر ممکن در ErrorType مطابقت داشته باشد.
  • issueId (string): شناسه‌ای که خطا به آن اختصاص داده شده است. مقدار باید با مؤلفه {issue} از issue name مطابقت داشته باشد.
  • deviceRamBucket (int64): RAM دستگاه، به مگابایت، در دسته‌ها (مثلاً ۱۰۲۴ برای ۱ تا ۱٫۵ گیگابایت، ۴۰۹۶ برای ۴ تا ۶ گیگابایت).
  • deviceSocMake (string): سازنده سیستم روی تراشه اصلی دستگاه، مثلاً Samsung. مرجع
  • deviceSocModel (string): مدل سیستم روی تراشه اصلی دستگاه، برای مثال «Exynos 2100». مرجع
  • deviceCpuMake (string): سازنده CPU دستگاه، مثلاً Qualcomm.
  • ‫deviceCpuModel (string): مدل CPU دستگاه، برای مثال «Kryo 240».
  • deviceGpuMake (string): سازنده GPU دستگاه، مثلاً ARM.
  • deviceGpuModel (string): مدل GPU دستگاه، مثلاً Mali.
  • deviceGpuVersion (string): نسخه GPU دستگاه، مثلاً T750.
  • deviceVulkanVersion (string): نسخه Vulkan دستگاه، برای مثال «۴۱۹۸۴۰۰».
  • ‫deviceGlEsVersion (string): نسخه OpenGL ES دستگاه، برای مثال «۱۹۶۶۱۰».
  • ‫deviceScreenSize (string): اندازه صفحه‌نمایش دستگاه، مثلاً NORMAL (معمولی)، LARGE (بزرگ).
  • ‫deviceScreenDpi (string): تراکم صفحه‌نمایش دستگاه، مثلاً mdpi،‏ hdpi.
metrics[]

string

اختیاری. سنجه‌هایی که باید تجمیع شوند.

سنجه‌های پشتیبانی‌شده:

  • ‫errorReportCount (google.type.Decimal): تعداد مطلق گزارش‌های خطای تکی که برای برنامه دریافت شده است.
  • ‫distinctUsers (google.type.Decimal): تعداد کاربران متمایزی که گزارش‌هایشان دریافت شده است. باید دقت شود که این تعداد بیشتر از این تجمیع نشود، زیرا ممکن است باعث شود کاربران چندین بار شمرده شوند. این مقدار گرد نشده است، اما ممکن است تقریبی باشد.
pageSize

integer

اختیاری. حداکثر اندازه داده‌های برگردانده‌شده.

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

string

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

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

string

اختیاری. فیلترهایی که باید بر داده‌ها اعمال شود. عبارت فیلتر از استاندارد AIP-160 پیروی می‌کند و از فیلتر کردن براساس برابری همه ابعاد تفکیک و موارد زیر پشتیبانی می‌کند:

  • isUserPerceived (string): نشان می‌دهد که خطا توسط کاربر درک شده است یا نه، USER_PERCEIVED یا NOT_USER_PERCEIVED.

بدنه پاسخ

پاسخ پُرسمان تعداد خطا.

درصورت موفقیت‌آمیز بودن، بدنه پاسخ حاوی داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
فیلدها
rows[]

object (MetricsRow)

ردیف‌های برگردانده‌شده.
nextPageToken

string

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

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

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

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

برای اطلاعات بیشتر، به OAuth 2.0 Overview مراجعه کنید.