Method: vitals.anrrate.query
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
HTTP 要求
POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/anrRateMetricSet}:query
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
name |
string
必要欄位。資源名稱。 格式:apps/{app}/anrRateMetricSet
|
要求主體
要求主體的資料會採用以下結構:
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 ):使用者裝置上執行的 Android API 級別,例如 26.
versionCode (int64 ):使用者裝置上執行的應用程式版本。
deviceModel (string ):使用者裝置型號的專屬 ID。識別碼格式為「deviceBrand/device」,其中 deviceBrand 對應於 Build.BRAND,device 則對應於 Build.DEVICE,例如「google/coral」。
deviceBrand (string ):使用者裝置品牌的專屬 ID,例如 google。
deviceType (string ):使用者裝置的類型 (也稱為板型規格),例如PHONE.
countryCode (string ):根據使用者 IP 位址判斷的裝置國家/地區,以 2 個字母的 ISO-3166 代碼表示 (例如美國為「US」)。
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
要匯總的指標。 支援的指標:
anrRate (google.type.Decimal ):在彙整期間,至少發生一次 ANR 的不重複使用者百分比。
anrRate7dUserWeighted (google.type.Decimal ):過去 7 天的 anrRate 累計平均值。每日值會根據當天的不重複使用者人數加權計算。不支援「每小時」細分程度。
anrRate28dUserWeighted (google.type.Decimal ):過去 28 天的 anrRate 累計平均值。每日值會根據當天的不重複使用者人數加權計算。不支援「每小時」細分程度。
userPerceivedAnrRate (google.type.Decimal ):在彙整期間,至少發生一次使用者感知 ANR 的不重複使用者百分比。目前,使用者感知 ANR 是指「輸入分派」類型的 ANR。
userPerceivedAnrRate7dUserWeighted (google.type.Decimal ):過去 7 天的userPerceivedAnrRate 累計平均值。每日值會根據當天的不重複使用者人數加權計算。不支援每小時細分數字。
userPerceivedAnrRate28dUserWeighted (google.type.Decimal ):過去 28 天的userPerceivedAnrRate 累計平均值。每日值會根據當天的不重複使用者人數加權計算。Not . 支援以「每小時」為單位。
distinctUsers (google.type.Decimal ):匯總期間內的不重複使用者人數,用來做為 anrRate 和 userPerceivedAnrRate 指標的正規化值。如果使用者在彙整期間於前景使用應用程式,就會計入這項指標。請務必不要進一步匯總這項計數,否則可能會導致系統重複計算使用者。系統會根據值的大小,將值四捨五入至最接近的 10、100、1,000 或 1,000,000 倍數。
|
filter |
string
要套用至資料的篩選器。篩選運算式遵循 AIP-160 標準,並支援依所有細分維度的等號進行篩選。
|
pageSize |
integer
傳回資料的大小上限。 如未指定,最多將傳回 1000 列。許可的最大值為 100,000;超出的數值將一律指定為 100,000。
|
pageToken |
string
屬於接收自前一個呼叫的網頁權杖。提供此項目即可擷取後續網頁。 進行分頁時,提供至要求的所有其他參數須與提供網頁權杖的呼叫相符。
|
userCohort |
enum (UserCohort )
選取要使用的使用者檢視畫面。輸出資料會對應至所選檢視畫面。 支援的值:
|
回應主體
anrrate.query
的回應訊息。
如果成功,回應主體會含有以下結構的資料:
JSON 表示法 |
{
"rows": [
{
object (MetricsRow )
}
],
"nextPageToken": string
} |
欄位 |
rows[] |
object (MetricsRow )
傳回的資料列。
|
nextPageToken |
string
用於擷取下一頁資料的接續符記。
|
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/playdeveloperreporting
詳情請參閱OAuth 2.0 Overview。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-07-26 (世界標準時間)。"],[[["Queries ANR metrics within a specified timeframe, sliced by dimensions like API level, device model, and country."],["Allows filtering data based on dimension equality and supports pagination for large datasets."],["Requires the `https://www.googleapis.com/auth/playdeveloperreporting` OAuth scope for authorization."],["The request body accepts parameters for timeline specification, dimensions, metrics, filter, and more to refine the query."],["The response provides rows of data corresponding to the requested metrics and dimensions, along with a pagination token for accessing further results."]]],["This outlines how to query metrics for ANR (Application Not Responding) rates. A `POST` request is made to a specific URL, with the app's resource name provided as a path parameter. The request body specifies parameters including `timelineSpec`, `dimensions`, `metrics`, `filter`, `pageSize`, `pageToken`, and `userCohort` to customize the query. The `userCohort` parameter allows you to query `OS_PUBLIC`, `APP_TESTERS` and `OS_BETA` user data. The response contains `rows` of metric data and a `nextPageToken` for pagination.\n"]]