Method: vitals.errors.counts.query

查詢指標集中的指標。

HTTP 要求

POST https://playdeveloperreporting.googleapis.com/v1beta1/{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 API 級別,例如 26.
  • versionCode (int64):使用者裝置型號的專屬 ID。識別碼格式為「deviceBrand/device」,其中 deviceBrand 對應於 Build.BRAND,device 則對應於 Build.DEVICE,例如「google/coral」。
  • deviceModel (string):使用者裝置型號的專屬 ID。
  • deviceType (string):裝置板型規格的 ID,例如 PHONE.
  • reportType (string):錯誤類型。這個值應對應至 ErrorType 中的其中一個可能值。
  • issueId (string):系統指派錯誤的 ID。這個值應與 issue name{issue} 元件相符。
  • deviceRamBucket (int64):裝置的 RAM (以 MB 為單位),以儲存區的形式 (3 GB、4 GB 等)。
  • deviceSocMake (string):裝置主要系統單晶片的製造商,例如 Samsung。參考資料
  • 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

要匯總的指標。

支援的指標:

  • errorReportCount (google.type.Decimal):應用程式收到的個別錯誤報告絕對數量。
  • distinctUsers (google.type.Decimal):收到報告的不同使用者人數。請務必不要進一步匯總這項計數,否則可能會導致系統重複計算使用者。這個值不會四捨五入,但可能是約略值。
pageSize

integer

傳回資料的大小上限。

如未指定,最多將傳回 1000 列。許可的最大值為 100000;超出的數值將一律指定為 100000。

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