Method: publishers.items.queryMetrics

किसी आइटम की मेट्रिक के बारे में क्वेरी करना.

एचटीटीपी अनुरोध

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

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
name

string

ज़रूरी है. उस आइटम का नाम जिसकी मेट्रिक के लिए क्वेरी करनी है. फ़ॉर्मैट: publishers/{publisher}/items/{item}

क्वेरी पैरामीटर

पैरामीटर
timeSpec

object (TimeSpec)

ज़रूरी है. मेट्रिक सेट के लिए क्वेरी करने के लिए, समय की जानकारी.
metrics[]

string

ज़रूरी है. मेट्रिक सेट के लिए क्वेरी की जाने वाली मेट्रिक.

इस्तेमाल की जा सकने वाली मेट्रिक:

  • installs: आइटम इंस्टॉल किए जाने की संख्या.
  • installs-7d: पिछले सात दिनों में, आइटम इंस्टॉल किए जाने की संख्या.
  • uninstalls: आइटम को अनइंस्टॉल करने की संख्या.
  • users: आइटम के हर दिन के सक्रिय उपयोगकर्ताओं की संख्या.
  • users-7d: आइटम के सात दिन के सक्रिय उपयोगकर्ताओं की संख्या.
  • इंप्रेशन: पूरे स्टोरफ़्रंट पर आइटम के इंप्रेशन की संख्या.
  • page-views: आइटम की ज़्यादा जानकारी वाले पेज पर यूनीक व्यू की संख्या.
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 से ज़्यादा की वैल्यू को 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)

मेट्रिक से जुड़े यूनीक उपयोगकर्ताओं की संख्या (अगर लागू हो).