Method: publishers.items.queryMetrics

שליחת שאילתה לגבי המדדים של פריט.

בקשת HTTP

GET https://chromewebstore.googleapis.com/v2/{name=publishers/*/items/*}:queryMetrics

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של הנתיב

פרמטרים
name

string

חובה. שם הפריט שרוצים לשלוח שאילתה לגבי המדדים שלו. פורמט: publishers/{publisher}/items/{item}

פרמטרים של שאילתה

פרמטרים
timeSpec

object (TimeSpec)

חובה. מפרט הזמן שלגביו רוצים לשלוח שאילתה על קבוצת המדדים.
metrics[]

string

חובה. המדדים שרוצים לשלוח לגביהם שאילתה לקבוצת המדדים.

מדדים נתמכים:

  • installs: מספר ההתקנות של הפריט.
  • ‫installs-7d: מספר ההתקנות של הפריט ב-7 הימים האחרונים.
  • uninstalls: מספר הפעמים שהפריט הוסר.
  • users: מספר המשתמשים הפעילים ביום של הפריט.
  • ‫users-7d: מספר המשתמשים הפעילים בפריט ב-7 הימים האחרונים.
  • impressions: מספר החשיפות של הפריט בכל חזית החנות.
  • צפיות בדף: מספר הצפיות של משתמשים בדף הפרטים של הפריט.
dimensions[]

string

אופציונלי. מאפיינים שמשמשים לפילוח המדדים. אפשר לציין מאפיין אחד לכל היותר.

מידות נתמכות:

  • ‫os: מערכת ההפעלה של המשתמש.
  • ‫app-version: גרסת הפריט.
  • country: המדינה של המשתמש.
  • ‫install-source: מקור ההתקנה.
  • ‫install-type: סוג ההתקנה (מחנות האינטרנט, מוטבעת או אחרת).
  • language: השפה של המשתמש.
  • ‫enabled: אם הפריט מופעל או מושבת.
  • ‫utm-campaign: קמפיין ה-UTM של המשתמש.
  • ‫utm-content: תוכן ה-UTM של המשתמש.
  • ‫utm-medium: אמצעי ההגעה לאתר של המשתמש.
  • ‫utm-source: מקור ה-UTM של המשתמש.
  • ‫utm-term: מונח ה-UTM של המשתמש.
pageSize

integer

אופציונלי. מספר השורות המקסימלי שיוחזרו. אם לא מציינים ערך, יוחזרו עד 100 שורות. הערך המקסימלי הוא 1,000. ערכים גבוהים יותר יומרו ל-1,000.
pageToken

string

אופציונלי. טוקן של דף שהתקבל מקריאה קודמת. צריך להזין את הטוקן כדי לאחזר את הדף הבא.

כשמבצעים חלוקה לעמודים, כל הפרמטרים האחרים שסופקו לבקשה חייבים להיות זהים לקריאה שסיפקה את הטוקן של הדף.

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

הודעת תגובה ל-items.queryMetrics.

אם הפעולה מצליחה, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "metricRows": [
    {
      object (MetricRow)
    }
  ],
  "nextPageToken": string
}
שדות
metricRows[]

object (MetricRow)

שורות המדדים.
nextPageToken

string

טוקן שאפשר לשלוח כ-pageToken כדי לאחזר את הדף הבא. אם משמיטים את השדה הזה, לא יופיעו דפים נוספים.

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/chromewebstore
  • https://www.googleapis.com/auth/chromewebstore.readonly

TimeSpec

טווח תאריכים לשאילתות על מדדים.

ייצוג ב-JSON 
{
  "firstDate": {
    object (Date)
  },
  "lastDate": {
    object (Date)
  }
}
שדות
firstDate

object (Date)

אופציונלי. התאריך הראשון (כולל) של מפרט הזמן. אם לא מוגדר, לא יחול גבול תחתון.
lastDate

object (Date)

אופציונלי. התאריך האחרון (כולל) של מפרט הזמן. אם לא מוגדר, לא יחול גבול עליון.

תאריך

מייצג תאריך מלא או חלקי בלוח השנה, כמו יום הולדת. השעה ביום ואזור הזמן מצוינים במקום אחר או שהם לא משמעותיים. התאריך הוא לפי הלוח הגרגוריאני. הערך הזה יכול לייצג את אחד מהמצבים הבאים:

  • תאריך מלא, עם ערכי שנה, חודש ויום שאינם אפס.
  • חודש ויום, עם שנה אפס (לדוגמה, יום נישואין).
  • שנה בלבד, עם אפס בחודש ואפס ביום.
  • שנה וחודש, עם יום אפס (לדוגמה, תאריך תפוגה של כרטיס אשראי).

סוגים קשורים:

ייצוג ב-JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
שדות
year

integer

השנה של התאריך. הערך חייב להיות בין 1 ל-9999, או 0 כדי לציין תאריך בלי שנה.
month

integer

חודש בשנה. הערך חייב להיות בין 1 ל-12, או 0 כדי לציין שנה בלי חודש ויום.
day

integer

יום בחודש. הערך חייב להיות בין 1 ל-31, ותקף לשנה ולחודש, או 0 כדי לציין שנה בלבד או שנה וחודש שבהם היום לא משמעותי.

MetricRow

שורה אחת של ערכי מדדים ומאפיינים.

ייצוג ב-JSON 
{
  "date": {
    object (Date)
  },
  "dimensionValues": [
    string
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
שדות
date

object (Date)

תאריך הרשומה.
dimensionValues[]

string

עמודות של ערכי מאפיינים בשורה.
metricValues[]

object (MetricValue)

עמודות של מדדים בשורה.

MetricValue

מייצג את הערך של מדד יחיד

ייצוג ב-JSON 
{
  "metric": string,
  "value": string,
  "uniqueUserCount": string
}
שדות
metric

string

שם המדד
value

string (int64 format)

הערך של המדד.
uniqueUserCount

string (int64 format)

מספר המשתמשים הייחודיים שמשויכים למדד (אם רלוונטי).