Method: vitals.crashrate.query

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

درخواست HTTP

POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/crashRateMetricSet}:query

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

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

مولفه های
name

string

ضروری. نام منبع

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

درخواست بدن

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

نمایندگی JSON
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
زمینه های
timelineSpec

object ( TimelineSpec )

تعیین پارامترهای تجمع جدول زمانی.

دوره های تجمع پشتیبانی شده:

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

string

ابعاد برای برش معیارها.

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

  • apiLevel ( string ): سطح API اندروید که در دستگاه کاربر اجرا می شد، به عنوان مثال، 26.
  • versionCode ( int64 ): نسخه ای از برنامه که در دستگاه کاربر در حال اجرا بود.
  • deviceModel ( string ): شناسه منحصر به فرد مدل دستگاه کاربر. شکل شناسه «deviceBrand/device» است، که در آن deviceBrand با Build.BRAND و دستگاه مربوط به Build.DEVICE است، به عنوان مثال، google/coral.
  • deviceBrand ( string ): شناسه منحصر به فرد برند دستگاه کاربر، به عنوان مثال، google.
  • deviceType ( string ): نوع (همچنین به عنوان فاکتور فرم شناخته می شود) دستگاه کاربر، به عنوان مثال، PHONE.
  • countryCode ( string ): کشور یا منطقه دستگاه کاربر بر اساس آدرس IP وی که به صورت کد ISO-3166 2 حرفی نشان داده شده است (مثلاً ایالات متحده برای ایالات متحده).
  • deviceRamBucket ( int64 ): رم دستگاه، در مگابایت، در سطل (3 گیگابایت، 4 گیگابایت و غیره).
  • deviceSocMake ( string ): ساخت سیستم روی تراشه اصلی دستگاه، به عنوان مثال، سامسونگ. ارجاع
  • deviceSocModel ( string ): مدل سیستم روی تراشه اصلی دستگاه، به عنوان مثال، "Exynos 2100". ارجاع
  • deviceCpuMake ( string ): ساخت CPU دستگاه، به عنوان مثال، Qualcomm.
  • deviceCpuModel ( string ): مدل CPU دستگاه، به عنوان مثال، "Kryo 240".
  • deviceGpuMake ( string ): ساخته شده از GPU دستگاه، به عنوان مثال، ARM.
  • deviceGpuModel ( string ): مدل GPU دستگاه، به عنوان مثال، مالی.
  • deviceGpuVersion ( string ): نسخه GPU دستگاه، به عنوان مثال، T750.
  • deviceVulkanVersion ( string ): نسخه Vulkan دستگاه، به عنوان مثال، "4198400".
  • deviceGlEsVersion ( string ): نسخه OpenGL ES دستگاه، به عنوان مثال، "196610".
  • deviceScreenSize ( string ): اندازه صفحه دستگاه، به عنوان مثال، NORMAL، LARGE.
  • deviceScreenDpi ( string ): تراکم صفحه دستگاه، به عنوان مثال، mdpi، hdpi.
metrics[]

string

معیارها برای تجمیع

معیارهای پشتیبانی شده:

  • crashRate ( google.type.Decimal ): درصدی از کاربران متمایز در دوره تجمع که حداقل یک خرابی را تجربه کرده‌اند.
  • crashRate7dUserWeighted ( google.type.Decimal ): مقدار متوسط crashRate در 7 روز گذشته. مقادیر روزانه با تعداد کاربران مجزا برای روز وزن می شود.
  • crashRate28dUserWeighted ( google.type.Decimal ): مقدار متوسط crashRate در 28 روز گذشته. مقادیر روزانه با تعداد کاربران مجزا برای روز وزن می شود. در جزئیات HOURLY پشتیبانی نمی شود.
  • userPerceivedCrashRate ( google.type.Decimal ): درصدی از کاربران متمایز در دوره تجمع که حداقل یک خرابی را در حین استفاده فعال از برنامه شما تجربه کردند (یک خرابی توسط کاربر). اگر برنامه‌ای در حال نمایش فعالیت یا اجرای هر سرویس پیش‌زمینه باشد، در حال استفاده فعال در نظر گرفته می‌شود.
  • userPerceivedCrashRate7dUserWeighted ( google.type.Decimal ): میانگین چرخشی مقدار userPerceivedCrashRate در 7 روز گذشته. مقادیر روزانه با تعداد کاربران مجزا برای روز وزن می شود. در جزئیات HOURLY پشتیبانی نمی شود.
  • userPerceivedCrashRate28dUserWeighted ( google.type.Decimal ): مقدار میانگین متغیر userPerceivedCrashRate در 28 روز گذشته. مقادیر روزانه با تعداد کاربران مجزا برای روز وزن می شود. در جزئیات HOURLY پشتیبانی نمی شود.
  • distinctUsers ( google.type.Decimal ): تعداد کاربران متمایز در دوره تجمیع که به عنوان مقدار عادی سازی برای معیارهای crashRate و userPerceivedCrashRate استفاده شده اند. اگر کاربر در طول دوره تجمیع به طور فعال از برنامه استفاده کرده باشد، در این معیار محاسبه می‌شود. اگر برنامه‌ای در حال نمایش فعالیت یا اجرای هر سرویس پیش‌زمینه باشد، در حال استفاده فعال در نظر گرفته می‌شود. باید مراقب بود که این تعداد بیشتر جمع نشود، زیرا ممکن است منجر به چندین بار شمارش کاربران شود. بسته به بزرگی مقدار، مقدار به نزدیکترین مضرب 10، 100، 1000 یا 1000000 گرد می شود.
filter

string

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

pageSize

integer

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

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

pageToken

string

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

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

userCohort

enum ( UserCohort )

نمای کاربر برای انتخاب. داده های خروجی با نمای انتخاب شده مطابقت دارد.

مقادیر پشتیبانی شده:

  • OS_PUBLIC برای انتخاب داده‌ها از همه نسخه‌های Android منتشر شده عمومی. این پیش فرض است. پشتیبانی از تمام ابعاد فوق
  • APP_TESTERS برای انتخاب داده از کاربرانی که آزمایش کننده بودن را انتخاب کرده اند. پشتیبانی از تمام ابعاد فوق
  • OS_BETA برای انتخاب داده‌ها فقط از نسخه‌های اندروید بتا، به استثنای داده‌های نسخه‌های اندروید منتشر شده. فقط ابعاد زیر پشتیبانی می شود:
  • versionCode ( int64 ): نسخه ای از برنامه که در دستگاه کاربر در حال اجرا بود.

  • osBuild ( string ): ساخت سیستم عامل دستگاه کاربر، به عنوان مثال، "T1B2.220916.004".

بدن پاسخگو

پیام پاسخ برای crashrate.query .

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

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

object ( MetricsRow )

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

nextPageToken

string

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

محدوده مجوز

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

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

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