Method: vitals.errors.counts.query
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
שליחת שאילתה על המדדים בקבוצת המדדים.
בקשת HTTP
POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/errorCountMetricSet}:query
בכתובת ה-URL נעשה שימוש בתחביר המרת 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 של Android שפעל במכשיר של המשתמש, למשל, 26.
versionCode (int64 ): מזהה ייחודי של דגם המכשיר של המשתמש. צורת המזהה היא 'deviceBrand/device', כאשר deviceBrand תואם ל-Build.BRAND והמכשיר מתאים ל-Build.DEVICE. למשל, google/coral.
deviceModel (string ): מזהה ייחודי של דגם המכשיר של המשתמש.
deviceType (string ): מזהה של גורם הצורה של המכשיר, למשל, טלפון.
reportType (string ): סוג השגיאה. הערך צריך להתאים לאחד מהערכים האפשריים ב-ErrorType .
isUserPerceived (string ): מציין אם השגיאה השפיעה על המשתמשים, USER_PERCEIVED או NOT_USER_PERCEIVED.
issueId (string ): המזהה שהוקצה לו שגיאה. הערך צריך להתאים לרכיב {issue} של issue name .
deviceRamBucket (int64 ): RAM של המכשיר, ב-MB, בקטגוריות (3GB , 4GB וכו').
deviceSocMake (string ): סוג המערכת על שבב (SoC) הראשי של המכשיר, למשל, Samsung. חומרי עזר
deviceSocModel (string ): דגם המערכת על שבב (SoC) הראשית של המכשיר, למשל, "Exynos 2100". חומרי עזר
deviceCpuMake (string ): סוג המעבד (CPU) של המכשיר, למשל, Qualcomm.
deviceCpuModel (string ): דגם המעבד של המכשיר, למשל, "Kryo 240".
deviceGpuMake (string ): סוג ה-GPU של המכשיר, למשל, דריכה.
deviceGpuModel (string ): דגם ה-GPU של המכשיר, למשל, מאלי.
deviceGpuVersion (string ): גרסת ה-GPU של המכשיר, למשל, 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
הגודל המקסימלי של הנתונים שיוחזרו. אם לא צוין אחרת, יוחזרו עד 1,000 שורות. הערך המקסימלי הוא 100,000. ערכים מעל 100,000 יובילו ל-100,000.
|
pageToken |
string
אסימון דף שהתקבל משיחה קודמת. צריך לספק אותו כדי לאחזר את הדף הבא. במהלך העימוד, כל הפרמטרים האחרים שסיפקתם לבקשה חייבים להתאים לקריאה שסיפקה את אסימון הדף.
|
filter |
string
המסננים שיחולו על הנתונים. ביטוי הסינון תואם לתקן AIP-160 ותומך בסינון לפי שוויון בכל מאפייני הפירוט.
|
גוף התגובה
שגיאות סופרות תגובה לשאילתה.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
{
"rows": [
{
object (MetricsRow )
}
],
"nextPageToken": string
} |
שדות |
rows[] |
object (MetricsRow )
השורות שהוחזרו.
|
nextPageToken |
string
אסימון המשך לאחזור דף הנתונים הבא.
|
היקפי הרשאות
נדרש היקף OAuth הבא:
https://www.googleapis.com/auth/playdeveloperreporting
למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2023-11-29 (שעון UTC).
[[["התוכן קל להבנה","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"]],["עדכון אחרון: 2023-11-29 (שעון UTC)."],[[["Queries error count metrics within a specified app and timeframe, allowing for filtering and aggregation by various dimensions."],["Utilizes a POST request to `https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/errorCountMetricSet}:query` with the app's resource name as a path parameter."],["Requires a request body specifying the timeline, dimensions, metrics, and optional filtering criteria for the query."],["The response includes rows of aggregated metrics data and a token for pagination if necessary."],["Authorization necessitates the `https://www.googleapis.com/auth/playdeveloperreporting` OAuth scope."]]],["This outlines querying metrics from a metric set via a `POST` request to a specified URL, utilizing gRPC Transcoding. The request requires a `name` path parameter and a body containing `timelineSpec`, `dimensions`, and `metrics` for data aggregation. Optional parameters include `pageSize`, `pageToken`, and `filter`. The response returns rows of metric data and a `nextPageToken` for pagination, with results being filtered by specified dimensions and metrics. Authorization requires the `playdeveloperreporting` OAuth scope.\n"]]