Method: publishers.items.queryMetrics

الاستعلام عن مقاييس عنصر معيّن

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
name

string

الحقل مطلوب. اسم العنصر المطلوب الاستعلام عن مقاييسه التنسيق: publishers/{publisher}/items/{item}

مَعلمات طلب البحث

المعلمات
timeSpec

object (TimeSpec)

الحقل مطلوب. مواصفات الوقت لطلب البحث عن مجموعة المقاييس
metrics[]

string

الحقل مطلوب. المقاييس التي يتم طلب مجموعة المقاييس لها

المقاييس المتاحة:

  • installs: عدد عمليات تثبيت العنصر
  • installs-7d: عدد عمليات تثبيت المنتج في آخر 7 أيام
  • uninstalls: عدد عمليات إلغاء تثبيت الإضافة
  • users: عدد المستخدمين النشطين يوميًا للعنصر
  • users-7d: عدد المستخدمين النشطين للعنصر خلال 7 أيام
  • impressions: عدد مرات ظهور السلع في واجهة المتجر بالكامل
  • page-views: عدد مرات المشاهدة الفردية لصفحة تفاصيل الإضافة
dimensions[]

string

اختيارية: السمات التي يتم تقسيم المقاييس حسبها يمكن تحديد سمة واحدة على الأكثر.

السمات المتوافقة:

  • os: نظام تشغيل المستخدم
  • ‫app-version: إصدار السلعة
  • country: بلد المستخدم
  • ‫install-source: مصدر التثبيت
  • install-type: نوع التثبيت (من سوق Chrome الإلكتروني أو مضمّن أو غير ذلك)
  • language: لغة المستخدم
  • enabled: يشير إلى ما إذا كان العنصر مفعَّلاً أو غير مفعَّل.
  • utm-campaign: حملة UTM للمستخدم
  • utm-content: محتوى UTM الخاص بالمستخدم
  • utm-medium: وسيط UTM للمستخدم
  • utm-source: مصدر UTM للمستخدم
  • utm-term: عبارة UTM للمستخدم
pageSize

integer

اختيارية: الحد الأقصى لعدد الصفوف المطلوب عرضها. إذا لم يتم تحديدها، سيتم عرض 100 صف كحد أقصى. الحد الأقصى للقيمة هو 1000، وسيتم فرض القيم التي تزيد عن 1000 على 1000.
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)

عدد المستخدمين الفريدين المرتبط بالمقياس (إذا كان ذلك منطبقًا)