Method: publishers.items.queryMetrics

سنجه‌های موردی را پُرسمان کنید.

درخواست HTTP

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

نشانی وب از نحو تراتبدیل gRPC استفاده می‌کند.

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

پارامترها
name

string

الزامی. نام موردی که می‌خواهید سنجه‌های آن را پُرسمان کنید. قالب: publishers/{publisher}/items/{item}

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

پارامترها
timeSpec

object (TimeSpec)

الزامی. مشخصات زمانی برای پُرسمان مجموعه سنجه.
metrics[]

string

الزامی. سنجه‌هایی که مجموعه سنجه برای آن‌ها پُرسمان می‌شود.

سنجه‌های پشتیبانی‌شده:

  • نصب‌ها: تعداد دفعات نصب مورد.
  • installs-7d: تعداد نصب‌های مورد در ۷ روز گذشته.
  • uninstalls: تعداد موارد حذف نصب مورد.
  • کاربران: تعداد کاربران فعال روزانه محصول.
  • users-7d: تعداد کاربران فعال ۷ روزه محصول.
  • دفعات درج: تعداد دفعات درج مورد در کل ویترین فروشگاه.
  • بازدیدهای صفحه: تعداد بازدیدهای مجزا از صفحه جزئیات مورد.
dimensions[]

string

اختیاری. ابعادی که سنجه‌ها براساس آن‌ها تقسیم می‌شوند. حداکثر یک بُعد را می‌توان مشخص کرد.

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

  • os: سیستم‌عامل کاربر.
  • app-version: نسخه مورد.
  • country: کشور کاربر.
  • install-source: منبع نصب.
  • install-type: نوع نصب (از نت‌بازار، درون‌خطی، یا غیره).
  • language: زبان کاربر.
  • enabled: اگر مورد فعال یا غیرفعال باشد.
  • utm-campaign: کمپین UTM کاربر.
  • utm-content: محتوای UTM کاربر.
  • utm-medium: رسانه UTM کاربر.
  • utm-source: منبع UTM کاربر.
  • utm-term: عبارت UTM کاربر.
pageSize

integer

اختیاری. حداکثر تعداد ردیف‌ها برای برگرداندن. اگر مشخص نشده باشد، حداکثر ۱۰۰ ردیف برگردانده می‌شود. حداکثر مقدار ۱۰۰۰ است؛ مقادیر بالاتر از ۱۰۰۰ به ۱۰۰۰ تبدیل خواهند شد.
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

سال تاریخ. باید از ۱ تا ۹۹۹۹ باشد، یا ۰ برای مشخص کردن تاریخ بدون سال.
month

integer

ماهی از سال. باید از ۱ تا ۱۲ باشد، یا ۰ برای مشخص کردن سال بدون ماه و روز.
day

integer

روز ماه. باید از ۱ تا ۳۱ و برای سال و ماه معتبر باشد، یا ۰ باشد تا سال به‌تنهایی یا سال و ماه را در شرایطی که روز مهم نیست مشخص کند.

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)

تعداد کاربر یکتای مرتبط با سنجه (درصورت وجود).