Method: vitals.errors.counts.query

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

درخواست HTTP

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

این URL از سینتکس Transcoding در 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 ): سطح API اندروید که روی دستگاه کاربر اجرا می‌شد، مثلاً ۲۶.
  • 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 ): رم دستگاه، بر حسب مگابایت، در دسته‌ها (۳ گیگابایت، ۴ گیگابایت و غیره).
  • deviceSocMake ( string ): سازنده‌ی سیستم-روی-تراشه اصلی دستگاه، مثلاً سامسونگ. مرجع
  • deviceSocModel ( string ): مدل سیستم روی تراشه اصلی دستگاه، مثلاً "Exynos 2100". مرجع
  • deviceCpuMake ( string ): سازنده‌ی پردازنده‌ی دستگاه، مثلاً کوالکام.
  • deviceCpuModel ( string ): مدل CPU دستگاه، مثلاً "Kryo 240".
  • deviceGpuMake ( string ): سازنده‌ی پردازنده‌ی گرافیکی دستگاه، مثلاً ARM.
  • deviceGpuModel ( string ): مدل پردازنده گرافیکی دستگاه، مثلاً Mali.
  • deviceGpuVersion ( string ): نسخه پردازنده گرافیکی دستگاه، مثلاً T750.
  • deviceVulkanVersion ( string ): نسخه Vulkan دستگاه، مثلاً "4198400".
  • deviceGlEsVersion ( string ): نسخه OpenGL ES دستگاه، مثلاً "196610".
  • deviceScreenSize ( string ): اندازه صفحه نمایش دستگاه، مثلاً معمولی، بزرگ.
  • 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 .