Method: publishers.items.queryMetrics

Bir öğenin metriklerini sorgulama

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
name

string

Zorunlu. Metrikleri sorgulanacak öğenin adı. Biçim: publishers/{publisher}/items/{item}

Sorgu parametreleri

Parametreler
timeSpec

object (TimeSpec)

Zorunlu. Metrik grubunun sorgulanacağı zaman spesifikasyonu.
metrics[]

string

Zorunlu. Metrik kümesinin sorgulanacağı metrikler.

Desteklenen metrikler:

  • installs: Öğe yükleme sayısı.
  • installs-7d: Son 7 gün içindeki öğe yükleme sayısı.
  • uninstalls: Öğe kaldırma sayısı.
  • users: Öğenin günlük etkin kullanıcı sayısı.
  • users-7d: Öğenin 7 günlük etkin kullanıcı sayısı.
  • impressions: Mağaza vitrininin tamamındaki öğe gösterimlerinin sayısı.
  • page-views: Öğenin ayrıntılar sayfasının toplam görüntülenme sayısı.
dimensions[]

string

İsteğe bağlıdır. Metriklerin dilimleneceği boyutlar. En fazla bir boyut belirtilebilir.

Desteklenen boyutlar:

  • os: Kullanıcının işletim sistemi.
  • app-version: Öğenin sürümü.
  • country: Kullanıcının ülkesi.
  • install-source: Yüklemenin kaynağı.
  • install-type: Yükleme türü (Chrome Web Mağazası'ndan, satır içi veya diğer).
  • language: Kullanıcının dili.
  • enabled: Öğenin etkin veya devre dışı olup olmadığı.
  • utm-campaign: Kullanıcının UTM kampanyası.
  • utm-content: Kullanıcının UTM içeriği.
  • utm-medium: Kullanıcının UTM aracısı.
  • utm-source: Kullanıcının UTM kaynağı.
  • utm-term: Kullanıcının UTM terimi.
pageSize

integer

İsteğe bağlıdır. Döndürülecek maksimum satır sayısı. Belirtilmezse en fazla 100 satır döndürülür. Maksimum değer 1.000'dir. 1.000'in üzerindeki değerler 1.000'e zorlanır.
pageToken

string

İsteğe bağlıdır. Önceki bir çağrıdan alınan sayfa jetonu. Sonraki sayfayı almak için bu değeri sağlayın.

Sayfalandırma yapılırken isteğe sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

items.queryMetrics için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "metricRows": [
    {
      object (MetricRow)
    }
  ],
  "nextPageToken": string
}
Alanlar
metricRows[]

object (MetricRow)

Metrik satırları.
nextPageToken

string

Sonraki sayfayı almak için pageToken olarak gönderilebilecek bir jeton. Bu alan atlanırsa sonraki sayfa yoktur.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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

TimeSpec

Metrikleri sorgulamak için tarih aralığı.

JSON gösterimi 
{
  "firstDate": {
    object (Date)
  },
  "lastDate": {
    object (Date)
  }
}
Alanlar
firstDate

object (Date)

İsteğe bağlıdır. Zaman spesifikasyonunun ilk tarihi (dahil). Ayarlanmazsa alt sınır uygulanmaz.
lastDate

object (Date)

İsteğe bağlıdır. Zaman spesifikasyonunun son tarihi (dahil). Ayarlanmazsa üst sınır uygulanmaz.

Tarih

Doğum günü gibi tam veya kısmi bir takvim tarihini temsil eder. Günün saati ve saat dilimi başka bir yerde belirtilmiştir veya önemsizdir. Tarih, Miladi Takvim'e göredir. Bu, aşağıdakilerden birini temsil edebilir:

  • Sıfır olmayan yıl, ay ve gün değerlerini içeren tam bir tarih.
  • Yılın sıfır olduğu bir ay ve gün (örneğin, yıl dönümü).
  • Ay ve günün sıfır olduğu, yalnızca yılın belirtildiği tarih.
  • Sıfır gün içeren bir yıl ve ay (örneğin, kredi kartının son kullanma tarihi).

İlgili türler:

JSON gösterimi 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Alanlar
year

integer

Tarihin yılı. 1 ile 9999 arasında olmalıdır veya yıl olmadan bir tarih belirtmek için 0 olmalıdır.
month

integer

Yılın ayı. 1 ile 12 arasında olmalıdır. Ay ve gün olmadan bir yıl belirtmek için 0 olmalıdır.
day

integer

Ayın günü. 1 ile 31 arasında olmalı ve yıl ile ay için geçerli olmalıdır. Yılı tek başına veya günün önemli olmadığı bir yıl ve ayı belirtmek için 0 olmalıdır.

MetricRow

Tek bir metrik ve boyut değerleri satırı.

JSON gösterimi 
{
  "date": {
    object (Date)
  },
  "dimensionValues": [
    string
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
Alanlar
date

object (Date)

Kaydın tarihi.
dimensionValues[]

string

Satırın boyut değeri sütunları.
metricValues[]

object (MetricValue)

Satırın metrik sütunları.

MetricValue

Tek bir metriğin değerini gösterir.

JSON gösterimi 
{
  "metric": string,
  "value": string,
  "uniqueUserCount": string
}
Alanlar
metric

string

Metriğin adı
value

string (int64 format)

Metriğin değeri.
uniqueUserCount

string (int64 format)

Metrikle ilişkili benzersiz kullanıcı sayısı (varsa).