REST Resource: properties.reportTasks

संसाधन: ReportTask

रिपोर्ट से जुड़े किसी टास्क का कॉन्फ़िगरेशन.

JSON के काेड में दिखाना
{
  "name": string,
  "reportDefinition": {
    object (ReportDefinition)
  },
  "reportMetadata": {
    object (ReportMetadata)
  }
}
फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. आइडेंटिफ़ायर. रिपोर्ट टास्क के लिए, रिपोर्ट बनाते समय असाइन किया गया रिसॉर्स का नाम. फ़ॉर्मैट: "properties/{property}/reportTasks/{reportTask}"

reportDefinition

object (ReportDefinition)

ज़रूरी नहीं. रिपोर्ट का डेटा फ़ेच करने के लिए रिपोर्ट की परिभाषा. इससे रिपोर्ट के स्ट्रक्चर के बारे में पता चलता है. इसमें आम तौर पर वे फ़ील्ड शामिल होते हैं जिन्हें रिपोर्ट में शामिल किया जाएगा. साथ ही, इसमें वे शर्तें भी शामिल होती हैं जिनका इस्तेमाल डेटा को फ़िल्टर करने के लिए किया जाएगा.

reportMetadata

object (ReportMetadata)

सिर्फ़ आउटपुट के लिए. किसी रिपोर्ट टास्क के लिए रिपोर्ट मेटाडेटा. इससे रिपोर्ट के बारे में जानकारी मिलती है. आम तौर पर, इसमें यह जानकारी शामिल होती है: रिपोर्ट का संसाधन नाम, रिपोर्ट की स्थिति, रिपोर्ट बनाने का टाइमस्टैंप वगैरह,

ReportDefinition

रिपोर्ट को कैसे चलाया जाना चाहिए, इसकी जानकारी.

JSON के काेड में दिखाना
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "offset": string,
  "limit": string,
  "metricAggregations": [
    enum (MetricAggregation)
  ],
  "orderBys": [
    {
      object (OrderBy)
    }
  ],
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "samplingLevel": enum (SamplingLevel)
}
फ़ील्ड
dimensions[]

object (Dimension)

ज़रूरी नहीं. अनुरोध किए गए और दिखाए गए डाइमेंशन.

metrics[]

object (Metric)

ज़रूरी नहीं. अनुरोध की गई और दिखाई गई मेट्रिक.

dateRanges[]

object (DateRange)

ज़रूरी नहीं. पढ़ने के लिए डेटा की तारीख की सीमाएं. अगर तारीख की एक से ज़्यादा रेंज का अनुरोध किया जाता है, तो हर जवाब वाली लाइन में, तारीख की सीमा का इंडेक्स होगा. यह इंडेक्स शून्य से शुरू होता है. अगर तारीख की दो सीमाएं एक-दूसरे से ओवरलैप करती हैं, तो ओवरलैप होने वाले दिनों का इवेंट डेटा, तारीख की दोनों सीमाओं के लिए जवाब की पंक्तियों में शामिल किया जाता है. कोहॉर्ट के अनुरोध में, इस dateRanges को 'तय नहीं किया गया' के तौर पर सेट किया जाना चाहिए.

dimensionFilter

object (FilterExpression)

ज़रूरी नहीं. डाइमेंशन फ़िल्टर की मदद से, रिपोर्ट में सिर्फ़ कुछ डाइमेंशन वैल्यू के लिए अनुरोध किया जा सकता है. ज़्यादा जानने के लिए, उदाहरणों के साथ डाइमेंशन फ़िल्टर की बुनियादी बातें लेख पढ़ें. इस फ़िल्टर में मेट्रिक का इस्तेमाल नहीं किया जा सकता.

metricFilter

object (FilterExpression)

ज़रूरी नहीं. मेट्रिक का फ़िल्टर क्लॉज़. यह रिपोर्ट की लाइनों को एग्रीगेट करने के बाद लागू होता है. यह SQL के having-clause की तरह होता है. इस फ़िल्टर में डाइमेंशन का इस्तेमाल नहीं किया जा सकता.

offset

string (int64 format)

ज़रूरी नहीं. Google Analytics स्टोरेज से शुरू होने वाली लाइन की संख्या. पहली लाइन को लाइन 0 के तौर पर गिना जाता है.

रिपोर्ट टास्क बनाते समय, offset और limit पैरामीटर, Google Analytics स्टोरेज से डेटा की उन लाइनों के सबसेट को तय करते हैं जिन्हें जनरेट की गई रिपोर्ट में शामिल किया जाना है. उदाहरण के लिए, अगर Google Analytics स्टोरेज में कुल 3,00,000 लाइनें हैं, तो रिपोर्ट बनाने के शुरुआती टास्क में पहली 10,000 लाइनें हो सकती हैं. इनकी सीमा 10,000 और ऑफ़सेट 0 होगा. इसके बाद, रिपोर्ट जनरेट करने वाले दूसरे टास्क में, अगली 10,000 लाइनों को शामिल किया जा सकता है. इसके लिए, सीमा 10,000 और ऑफ़सेट 10,000 होना चाहिए.

limit

string (int64 format)

ज़रूरी नहीं. रिपोर्ट में दिखाई जाने वाली पंक्तियों की संख्या. अगर इस विकल्प को नहीं चुना जाता है, तो 10,000 पंक्तियां दिखती हैं. एपीआई, हर अनुरोध के लिए ज़्यादा से ज़्यादा 2,50,000 लाइनें दिखाता है. भले ही, आपने कितनी भी लाइनों का अनुरोध किया हो. limit पॉज़िटिव होनी चाहिए.

अगर डाइमेंशन की वैल्यू, अनुरोध की गई limit से कम हैं, तो एपीआई, अनुरोध की गई limit से कम पंक्तियां भी दिखा सकता है. उदाहरण के लिए, डाइमेंशन country के लिए 300 से कम संभावित वैल्यू हैं. इसलिए, सिर्फ़ country पर रिपोर्टिंग करते समय, आपको 300 से ज़्यादा लाइनें नहीं मिल सकतीं. भले ही, आपने limit को ज़्यादा वैल्यू पर सेट किया हो.

metricAggregations[]

enum (MetricAggregation)

ज़रूरी नहीं. मेट्रिक का एग्रीगेशन. एग्रीगेट की गई मेट्रिक वैल्यू, उन लाइनों में दिखेंगी जहां dimensionValues को "RESERVED_(MetricAggregation)" पर सेट किया गया है.

orderBys[]

object (OrderBy)

ज़रूरी नहीं. इससे यह तय होता है कि जवाब में पंक्तियों को किस क्रम में दिखाया जाएगा.

currencyCode

string

ज़रूरी नहीं. ISO4217 फ़ॉर्मैट में मुद्रा कोड, जैसे कि "AED", "USD", "JPY". अगर यह फ़ील्ड खाली है, तो रिपोर्ट में प्रॉपर्टी की डिफ़ॉल्ट मुद्रा का इस्तेमाल किया जाता है.

cohortSpec

object (CohortSpec)

ज़रूरी नहीं. इस अनुरोध से जुड़ा कोहॉर्ट ग्रुप. अगर अनुरोध में एक जैसे उपयोगकर्ताओं का ग्रुप है, तो 'कोहॉर्ट' डाइमेंशन मौजूद होना चाहिए.

keepEmptyRows

boolean

ज़रूरी नहीं. अगर यह विकल्प 'गलत' पर सेट है या इसकी वैल्यू तय नहीं की गई है, तो ऐसी हर लाइन को नहीं दिखाया जाएगा जिसमें सभी मेट्रिक की वैल्यू 0 के बराबर है. अगर यह वैल्यू सही है, तो इन लाइनों को तब तक नहीं हटाया जाएगा, जब तक कि इन्हें फ़िल्टर करके अलग से न हटाया जाए.

इस keepEmptyRows सेटिंग के बावजूद, रिपोर्ट में सिर्फ़ Google Analytics प्रॉपर्टी से रिकॉर्ड किया गया डेटा दिखाया जा सकता है.

उदाहरण के लिए, अगर कोई प्रॉपर्टी कभी purchase इवेंट लॉग नहीं करती है, तो eventName डाइमेंशन और eventCount मेट्रिक के लिए की गई क्वेरी में, eventName: "purchase" और eventCount: 0 वाली कोई लाइन नहीं होगी.

samplingLevel

enum (SamplingLevel)

ज़रूरी नहीं. रिपोर्ट का सैंपलिंग लेवल.

डाइमेंशन

डाइमेंशन आपके डेटा के एट्रिब्यूट होते हैं. उदाहरण के लिए, शहर के डाइमेंशन से पता चलता है कि इवेंट की शुरुआत किस शहर से हुई थी. रिपोर्ट के जवाबों में डाइमेंशन वैल्यू, स्ट्रिंग होती हैं. उदाहरण के लिए, शहर "पेरिस" या "न्यूयॉर्क" हो सकता है.

JSON के काेड में दिखाना
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
फ़ील्ड
name

string

डाइमेंशन का नाम. runReport और batchRunReports जैसी कोर रिपोर्टिंग के तरीकों के साथ काम करने वाले डाइमेंशन के नामों की सूची देखने के लिए, एपीआई डाइमेंशन देखें. runRealtimeReport तरीके के साथ काम करने वाले डाइमेंशन के नामों की सूची देखने के लिए, रीयलटाइम डाइमेंशन देखें. runFunnelReport तरीके के साथ काम करने वाले डाइमेंशन के नामों की सूची देखने के लिए, फ़नल डाइमेंशन देखें.

अगर dimensionExpression तय किया गया है, तो dimensionExpression ऐसी कोई भी स्ट्रिंग हो सकती है जिसे वर्णों के तय किए गए सेट में शामिल किया गया हो.name उदाहरण के लिए, अगर dimensionExpression, country और city को जोड़ता है, तो उस डाइमेंशन को countryAndCity कहा जा सकता है. चुने गए डाइमेंशन के नाम, रेगुलर एक्सप्रेशन ^[a-zA-Z0-9_]$ से मेल खाने चाहिए.

डाइमेंशन को name में dimensionFilter, orderBys, dimensionExpression, और pivots से रेफ़र किया जाता है.

dimensionExpression

object (DimensionExpression)

एक डाइमेंशन, कई डाइमेंशन के एक्सप्रेशन का नतीजा हो सकता है. उदाहरण के लिए, "देश, शहर" डाइमेंशन: concatenate(country, ", ", city).

DimensionExpression

इस फ़ंक्शन का इस्तेमाल, ऐसे डाइमेंशन को दिखाने के लिए किया जाता है जो कई डाइमेंशन के फ़ॉर्मूले का नतीजा होता है. इस्तेमाल के उदाहरण: 1) lowerCase(dimension) 2) concatenate(dimension1, symbol, dimension2).

JSON के काेड में दिखाना
{

  // Union field one_expression can be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union field one_expression.
}
फ़ील्ड
यूनियन फ़ील्ड one_expression. DimensionExpression के लिए, डाइमेंशन एक्सप्रेशन का एक टाइप तय करें. one_expression इनमें से सिर्फ़ एक हो सकता है:
lowerCase

object (CaseExpression)

इसका इस्तेमाल, डाइमेंशन वैल्यू को छोटे अक्षरों में बदलने के लिए किया जाता है.

upperCase

object (CaseExpression)

इसका इस्तेमाल, डाइमेंशन वैल्यू को अपर केस में बदलने के लिए किया जाता है.

concatenate

object (ConcatenateExpression)

इसका इस्तेमाल, डाइमेंशन की वैल्यू को एक डाइमेंशन में जोड़ने के लिए किया जाता है. उदाहरण के लिए, "देश, शहर" डाइमेंशन: concatenate(country, ", ", city).

CaseExpression

इसका इस्तेमाल, डाइमेंशन वैल्यू को किसी एक केस में बदलने के लिए किया जाता है.

JSON के काेड में दिखाना
{
  "dimensionName": string
}
फ़ील्ड
dimensionName

string

डाइमेंशन का नाम. नाम, अनुरोध के डाइमेंशन फ़ील्ड में मौजूद किसी नाम से मेल खाना चाहिए.

ConcatenateExpression

इसका इस्तेमाल, डाइमेंशन की वैल्यू को एक डाइमेंशन में जोड़ने के लिए किया जाता है.

JSON के काेड में दिखाना
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
फ़ील्ड
dimensionNames[]

string

डाइमेंशन के नाम. नामों का रेफ़रंस, अनुरोध के डाइमेंशन फ़ील्ड में मौजूद नामों से होना चाहिए.

delimiter

string

डाइमेंशन के नामों के बीच रखा गया डेलिमिटर.

डेलिमिटर अक्सर "|" या "," जैसे वर्ण होते हैं. हालांकि, ये लंबी स्ट्रिंग भी हो सकते हैं. अगर किसी डाइमेंशन वैल्यू में डेलिमिटर मौजूद है, तो दोनों वैल्यू बिना किसी अंतर के जवाब में मौजूद होंगी. उदाहरण के लिए, अगर डाइमेंशन 1 की वैल्यू = "US,FR", डाइमेंशन 2 की वैल्यू = "JP", और सीमांकक = "," है, तो जवाब में "US,FR,JP" शामिल होगा.

मेट्रिक

रिपोर्ट में मौजूद डेटा को संख्या में बताया जाता है. उदाहरण के लिए, eventCount मेट्रिक से इवेंट की कुल संख्या का पता चलता है. अनुरोधों में ज़्यादा से ज़्यादा 10 मेट्रिक शामिल की जा सकती हैं.

JSON के काेड में दिखाना
{
  "name": string,
  "expression": string,
  "invisible": boolean
}
फ़ील्ड
name

string

मेट्रिक का नाम. runReport और batchRunReports जैसे कोर रिपोर्टिंग के तरीकों के साथ काम करने वाले मेट्रिक के नामों की सूची देखने के लिए, एपीआई मेट्रिक देखें. runRealtimeReport तरीके के साथ काम करने वाली मेट्रिक के नामों की सूची देखने के लिए, रीयलटाइम मेट्रिक देखें. runFunnelReport तरीके के साथ काम करने वाली मेट्रिक के नामों की सूची देखने के लिए, फ़नल मेट्रिक देखें.

अगर expression तय किया गया है, तो expression ऐसी कोई भी स्ट्रिंग हो सकती है जिसे वर्णों के तय किए गए सेट में शामिल किया गया हो.name उदाहरण के लिए, अगर expression screenPageViews/sessions है, तो उस मेट्रिक का नाम = viewsPerSession रखा जा सकता है. चुने गए मेट्रिक के नाम, रेगुलर एक्सप्रेशन ^[a-zA-Z0-9_]$ से मेल खाने चाहिए.

मेट्रिक को metricFilter, orderBys, और मेट्रिक expression में name के हिसाब से रेफ़रंस दिया जाता है.

expression

string

आसानी से समझने के लिए बनाई गई मेट्रिक के लिए गणितीय एक्सप्रेशन. उदाहरण के लिए, हर उपयोगकर्ता के हिसाब से इवेंट की संख्या वाली मेट्रिक eventCount/totalUsers है.

invisible

boolean

इससे पता चलता है कि रिपोर्ट के जवाब में कोई मेट्रिक नहीं दिख रही है. अगर कोई मेट्रिक नहीं दिखती है, तो जवाब में उस मेट्रिक का कॉलम नहीं दिखेगा. हालांकि, उसका इस्तेमाल metricFilter, orderBys या मेट्रिक expression में किया जा सकता है.

DateRange

लगातार दिनों का सेट: startDate, startDate + 1, ..., endDate. तारीख की चार सीमाओं तक के अनुरोध किए जा सकते हैं.

JSON के काेड में दिखाना
{
  "startDate": string,
  "endDate": string,
  "name": string
}
फ़ील्ड
startDate

string

क्वेरी के लिए, शुरू होने की तारीख YYYY-MM-DD फ़ॉर्मैट में. यह endDate के बाद की नहीं होनी चाहिए. NdaysAgo, yesterday या today फ़ॉर्मैट भी स्वीकार किया जाता है. ऐसे में, तारीख का पता प्रॉपर्टी के रिपोर्टिंग टाइम ज़ोन के आधार पर लगाया जाता है.

endDate

string

क्वेरी के लिए, खत्म होने की तारीख YYYY-MM-DD के फ़ॉर्मैट में. startDate से पहले की नहीं होनी चाहिए. NdaysAgo, yesterday या today फ़ॉर्मैट भी स्वीकार किया जाता है. ऐसे में, तारीख का पता प्रॉपर्टी के रिपोर्टिंग टाइम ज़ोन के आधार पर लगाया जाता है.

name

string

इस तारीख की सीमा को कोई नाम असाइन करता है. रिपोर्ट के जवाब में, डाइमेंशन dateRange को इस नाम के तौर पर वैल्यू दी जाती है. अगर इसे सेट किया जाता है, तो यह date_range_ या RESERVED_ से शुरू नहीं हो सकता. अगर इसे सेट नहीं किया जाता है, तो तारीख की सीमाओं को अनुरोध में उनके ज़ीरो पर आधारित इंडेक्स के हिसाब से नाम दिया जाता है: date_range_0, date_range_1 वगैरह.

FilterExpression

डाइमेंशन या मेट्रिक फ़िल्टर को दिखाने के लिए. एक ही फ़िल्टर एक्सप्रेशन में मौजूद सभी फ़ील्ड, डाइमेंशन या मेट्रिक होने चाहिए.

JSON के काेड में दिखाना
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FilterExpressionList)
  },
  "orGroup": {
    object (FilterExpressionList)
  },
  "notExpression": {
    object (FilterExpression)
  },
  "filter": {
    object (Filter)
  }
  // End of list of possible types for union field expr.
}
फ़ील्ड
यूनियन फ़ील्ड expr. FilterExpression के लिए, फ़िल्टर एक्सप्रेशन का कोई एक टाइप तय करें. expr इनमें से सिर्फ़ एक हो सकता है:
andGroup

object (FilterExpressionList)

inAndGroup में मौजूद FilterExpressions के बीच AND रिलेशनशिप होता है.

orGroup

object (FilterExpressionList)

orGroup में मौजूद FilterExpressions के बीच OR संबंध होता है.

notExpression

object (FilterExpression)

FilterExpression, notExpression का नहीं है.

filter

object (Filter)

यह एक प्रिमिटिव फ़िल्टर है. एक ही फ़िल्टर एक्सप्रेशन में, फ़िल्टर के सभी फ़ील्ड के नाम या तो सभी डाइमेंशन या सभी मेट्रिक होने चाहिए.

FilterExpressionList

फ़िल्टर एक्सप्रेशन की सूची.

JSON के काेड में दिखाना
{
  "expressions": [
    {
      object (FilterExpression)
    }
  ]
}
फ़ील्ड
expressions[]

object (FilterExpression)

फ़िल्टर एक्सप्रेशन की सूची.

फ़िल्टर करें

डाइमेंशन या मेट्रिक वैल्यू को फ़िल्टर करने के लिए एक्सप्रेशन.

JSON के काेड में दिखाना
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  },
  "emptyFilter": {
    object (EmptyFilter)
  }
  // End of list of possible types for union field one_filter.
}
फ़ील्ड
fieldName

string

डाइमेंशन या मेट्रिक का नाम. यह डाइमेंशन या मेट्रिक में तय किया गया नाम होना चाहिए.

यूनियन फ़ील्ड one_filter. Filter के लिए, किसी एक तरह के फ़िल्टर की जानकारी दें. one_filter इनमें से सिर्फ़ एक हो सकता है:
stringFilter

object (StringFilter)

स्ट्रिंग से जुड़ा फ़िल्टर.

inListFilter

object (InListFilter)

सूची में मौजूद वैल्यू के लिए फ़िल्टर.

numericFilter

object (NumericFilter)

संख्या या तारीख की वैल्यू के लिए फ़िल्टर.

betweenFilter

object (BetweenFilter)

दो वैल्यू के बीच के डेटा को फ़िल्टर करने की सुविधा.

emptyFilter

object (EmptyFilter)

खाली वैल्यू के लिए फ़िल्टर, जैसे कि "(सेट नहीं)" और "" वैल्यू.

StringFilter

स्ट्रिंग के लिए फ़िल्टर

JSON के काेड में दिखाना
{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}
फ़ील्ड
matchType

enum (MatchType)

इस फ़िल्टर के लिए मैच टाइप.

value

string

मैचिंग के लिए इस्तेमाल की गई स्ट्रिंग वैल्यू.

caseSensitive

boolean

अगर यह वैल्यू सही है, तो स्ट्रिंग वैल्यू केस-सेंसिटिव होती है.

MatchType

स्ट्रिंग फ़िल्टर का मैच टाइप

Enums
MATCH_TYPE_UNSPECIFIED जानकारी उपलब्ध नहीं है
EXACT स्ट्रिंग वैल्यू का एग्ज़ैक्ट मैच.
BEGINS_WITH स्ट्रिंग वैल्यू से शुरू होती है.
ENDS_WITH स्ट्रिंग वैल्यू पर खत्म होती है.
CONTAINS इसमें स्ट्रिंग वैल्यू शामिल होती है.
FULL_REGEXP स्ट्रिंग वैल्यू के साथ रेगुलर एक्सप्रेशन का पूरा मैच.
PARTIAL_REGEXP स्ट्रिंग वैल्यू के साथ रेगुलर एक्सप्रेशन का कुछ हिस्सा मैच करता है.

InListFilter

नतीजा, स्ट्रिंग वैल्यू की सूची में होना चाहिए.

JSON के काेड में दिखाना
{
  "values": [
    string
  ],
  "caseSensitive": boolean
}
फ़ील्ड
values[]

string

स्ट्रिंग वैल्यू की सूची. यह खाली नहीं होना चाहिए.

caseSensitive

boolean

अगर यह वैल्यू सही है, तो स्ट्रिंग वैल्यू केस-सेंसिटिव होती है.

NumericFilter

संख्या या तारीख की वैल्यू के लिए फ़िल्टर.

JSON के काेड में दिखाना
{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}
फ़ील्ड
operation

enum (Operation)

इस फ़िल्टर के लिए ऑपरेशन टाइप.

value

object (NumericValue)

कोई संख्यात्मक वैल्यू या तारीख की वैल्यू.

कार्रवाई

संख्या वाले फ़िल्टर पर लागू किया गया ऑपरेशन

Enums
OPERATION_UNSPECIFIED नहीं बताया गया है
EQUAL Equal
LESS_THAN इससे कम
LESS_THAN_OR_EQUAL इससे कम या इसके बराबर
GREATER_THAN इससे ज़्यादा
GREATER_THAN_OR_EQUAL इससे ज़्यादा या इसके बराबर

NumericValue

किसी संख्या को दिखाने के लिए.

JSON के काेड में दिखाना
{

  // Union field one_value can be only one of the following:
  "int64Value": string,
  "doubleValue": number
  // End of list of possible types for union field one_value.
}
फ़ील्ड
यूनियन फ़ील्ड one_value. संख्यात्मक वैल्यू one_value इनमें से सिर्फ़ एक हो सकती है:
int64Value

string (int64 format)

पूर्णांक वैल्यू

doubleValue

number

दोहरा मान

BetweenFilter

यह बताने के लिए कि नतीजा दो संख्याओं के बीच होना चाहिए. इसमें ये दोनों संख्याएं भी शामिल हैं.

JSON के काेड में दिखाना
{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}
फ़ील्ड
fromValue

object (NumericValue)

इस नंबर से शुरू होता है.

toValue

object (NumericValue)

इस नंबर पर खत्म होता है.

EmptyFilter

इस टाइप के लिए कोई फ़ील्ड नहीं है.

खाली वैल्यू के लिए फ़िल्टर करें.

MetricAggregation

यह मेट्रिक के एग्रीगेशन को दिखाता है.

Enums
METRIC_AGGREGATION_UNSPECIFIED ऑपरेटर के बारे में जानकारी नहीं दी गई है.
TOTAL SUM ऑपरेटर.
MINIMUM कम से कम ऑपरेटर.
MAXIMUM मैक्सिमम ऑपरेटर.
COUNT गिनती करने वाला ऑपरेटर.

OrderBy

'इस क्रम से लगाएं' से यह तय होता है कि जवाब में पंक्तियों को किस क्रम में लगाया जाएगा. उदाहरण के लिए, इवेंट की संख्या के हिसाब से घटते क्रम में पंक्तियों को क्रम से लगाना एक तरह का क्रम है. वहीं, इवेंट के नाम की स्ट्रिंग के हिसाब से पंक्तियों को क्रम से लगाना एक अलग तरह का क्रम है.

JSON के काेड में दिखाना
{
  "desc": boolean,

  // Union field one_order_by can be only one of the following:
  "metric": {
    object (MetricOrderBy)
  },
  "dimension": {
    object (DimensionOrderBy)
  }
  // End of list of possible types for union field one_order_by.
}
फ़ील्ड
desc

boolean

अगर यह विकल्प चुना जाता है, तो डेटा को घटते क्रम में लगाया जाता है.

यूनियन फ़ील्ड one_order_by. OrderBy के लिए, ऑर्डर करने का एक तरीका तय करें. one_order_by इनमें से सिर्फ़ एक हो सकता है:
metric

object (MetricOrderBy)

इस विकल्प की मदद से, नतीजों को मेट्रिक की वैल्यू के हिसाब से क्रम से लगाया जाता है.

dimension

object (DimensionOrderBy)

यह फ़ंक्शन, डाइमेंशन की वैल्यू के हिसाब से नतीजों को क्रम से लगाता है.

MetricOrderBy

मेट्रिक वैल्यू के हिसाब से क्रम से लगाता है.

JSON के काेड में दिखाना
{
  "metricName": string
}
फ़ील्ड
metricName

string

अनुरोध में मौजूद मेट्रिक का नाम, जिसके हिसाब से क्रम से लगाना है.

DimensionOrderBy

डाइमेंशन वैल्यू के हिसाब से क्रम से लगाता है.

JSON के काेड में दिखाना
{
  "dimensionName": string,
  "orderType": enum (OrderType)
}
फ़ील्ड
dimensionName

string

अनुरोध में मौजूद डाइमेंशन का नाम, जिसके हिसाब से क्रम से लगाना है.

orderType

enum (OrderType)

यह विकल्प, डाइमेंशन वैल्यू को क्रम से लगाने के नियम को कंट्रोल करता है.

OrderType

स्ट्रिंग डाइमेंशन की वैल्यू को क्रम से लगाने का नियम.

Enums
ORDER_TYPE_UNSPECIFIED नहीं बताया गया है
ALPHANUMERIC यूनिकोड कोड पॉइंट के हिसाब से अक्षर और अंकों को क्रम से लगाएं. उदाहरण के लिए, "2" < "A" < "X" < "b" < "z".
CASE_INSENSITIVE_ALPHANUMERIC केस-इनसेंसिटिव, अक्षर और अंक के हिसाब से, छोटे अक्षरों के यूनिकोड कोड पॉइंट के हिसाब से क्रम से लगाएं. उदाहरण के लिए, "2" < "A" < "b" < "X" < "z".
NUMERIC डाइमेंशन की वैल्यू को क्रम से लगाने से पहले, उन्हें संख्याओं में बदल दिया जाता है. उदाहरण के लिए, संख्या के हिसाब से क्रम लगाने पर "25" < "100" होता है. वहीं, ALPHANUMERIC के हिसाब से क्रम लगाने पर "100" < "25" होता है. नॉन-न्यूमेरिक डाइमेंशन वैल्यू की ऑर्डरिंग वैल्यू, सभी न्यूमेरिक वैल्यू से कम होती है.

CohortSpec

एक जैसे उपयोगकर्ताओं के ग्रुप की रिपोर्ट के लिए, एक जैसे उपयोगकर्ताओं के ग्रुप की जानकारी.

एक जैसे उपयोगकर्ताओं के ग्रुप की रिपोर्ट, ग्रुप में शामिल उपयोगकर्ताओं के बने रहने की दर की टाइम सीरीज़ बनाती हैं. उदाहरण के लिए, सितंबर के पहले हफ़्ते में हासिल किए गए उपयोगकर्ताओं के ग्रुप को चुना जा सकता है. इसके बाद, अगले छह हफ़्तों तक उस ग्रुप को फ़ॉलो किया जा सकता है. सितंबर के पहले हफ़्ते में हासिल किए गए उपयोगकर्ताओं को चुनने के बारे में cohort ऑब्जेक्ट में बताया गया है. इसके बाद, अगले छह हफ़्तों के लिए उस कोहॉर्ट को cohortsRange ऑब्जेक्ट में बताया गया है.

उदाहरणों के लिए, एक जैसे उपयोगकर्ताओं के ग्रुप की रिपोर्ट के उदाहरण देखें.

रिपोर्ट के जवाब में, हफ़्ते के हिसाब से टाइम सीरीज़ दिख सकती है. इसमें यह बताया जा सकता है कि तीन हफ़्तों के बाद, आपके ऐप्लिकेशन ने इस कोहॉर्ट के 60% उपयोगकर्ताओं को बनाए रखा है. साथ ही, छह हफ़्तों के बाद, इस कोहॉर्ट के 25% उपयोगकर्ताओं को बनाए रखा है. इन दोनों प्रतिशत को cohortActiveUsers/cohortTotalUsers मेट्रिक से कैलकुलेट किया जा सकता है. साथ ही, ये रिपोर्ट में अलग-अलग लाइनों में दिखेंगी.

JSON के काेड में दिखाना
{
  "cohorts": [
    {
      object (Cohort)
    }
  ],
  "cohortsRange": {
    object (CohortsRange)
  },
  "cohortReportSettings": {
    object (CohortReportSettings)
  }
}
फ़ील्ड
cohorts[]

object (Cohort)

इस कुकी से, उपयोगकर्ताओं को एक जैसे उपयोगकर्ताओं के ग्रुप में शामिल करने के लिए चुनने की शर्तें तय की जाती हैं.

ज़्यादातर एक जैसे उपयोगकर्ताओं के ग्रुप की रिपोर्ट में, सिर्फ़ एक ग्रुप के बारे में जानकारी होती है. अगर एक से ज़्यादा कोहॉर्ट तय किए गए हैं, तो रिपोर्ट में हर कोहॉर्ट को उसके नाम से पहचाना जा सकता है.

cohortsRange

object (CohortsRange)

एक जैसे उपयोगकर्ताओं के ग्रुप की रिपोर्ट में, रिपोर्टिंग की तारीख की लंबी सीमा के दौरान, एक जैसे उपयोगकर्ताओं के ग्रुप को फ़ॉलो किया जाता है. इस रेंज से, ऑफ़सेट की अवधि के बारे में पता चलता है. इससे यह तय होता है कि कोहॉर्ट को कितने समय तक फ़ॉलो करना है.

cohortReportSettings

object (CohortReportSettings)

कोहॉर्ट रिपोर्ट के लिए वैकल्पिक सेटिंग.

समानता रखने वाले लोग

यह टैग, समानता रखने वाले लोगों को चुनने की शर्तों के बारे में बताता है. कोहॉर्ट, ऐसे उपयोगकर्ताओं के ग्रुप को कहते हैं जिनमें एक समान विशेषताएं होती हैं. उदाहरण के लिए, एक जैसे firstSessionDate वाले उपयोगकर्ता, एक ही कोहॉर्ट का हिस्सा होते हैं.

JSON के काेड में दिखाना
{
  "name": string,
  "dimension": string,
  "dateRange": {
    object (DateRange)
  }
}
फ़ील्ड
name

string

यह कुकी, इस कोहॉर्ट को कोई नाम असाइन करती है. रिपोर्ट के जवाब में, डाइमेंशन cohort को इस नाम के तौर पर वैल्यू दी जाती है. अगर इसे सेट किया जाता है, तो यह cohort_ या RESERVED_ से शुरू नहीं हो सकता. अगर इसे सेट नहीं किया जाता है, तो कोहॉर्ट के नाम उनके ज़ीरो पर आधारित इंडेक्स cohort_0, cohort_1 वगैरह के हिसाब से रखे जाते हैं.

dimension

string

कोहॉर्ट के लिए इस्तेमाल किया गया डाइमेंशन. यह एट्रिब्यूट ज़रूरी है. इसकी वैल्यू के तौर पर, सिर्फ़ firstSessionDate को इस्तेमाल किया जा सकता है.

dateRange

object (DateRange)

यह ग्रुप, उन उपयोगकर्ताओं को चुनता है जिनकी पहली बार इंटरैक्ट करने की तारीख, dateRange में तय की गई शुरू और खत्म होने की तारीख के बीच की है. इस dateRange से, इवेंट डेटा की पूरी तारीख की सीमा के बारे में पता नहीं चलता है. यह डेटा, किसी कोहॉर्ट रिपोर्ट में मौजूद होता है. कोहॉर्ट रिपोर्ट में, इस dateRange को cohortsRange में मौजूद ग्रेन्यूलैरिटी और ऑफ़सेट के हिसाब से बढ़ाया जाता है. बढ़ी हुई रिपोर्टिंग की तारीख की सीमा के लिए इवेंट डेटा, कोहॉर्ट रिपोर्ट में मौजूद होता है.

कोहॉर्ट के अनुरोध में, इस dateRange की ज़रूरत होती है. साथ ही, RunReportRequest या RunPivotReportRequest में मौजूद dateRanges को 'कोई नहीं' के तौर पर सेट किया जाना चाहिए.

यह dateRange आम तौर पर, कोहॉर्ट की बारीकी से जुड़ी जानकारी के साथ अलाइन होना चाहिए. अगर CohortsRange में हर दिन के हिसाब से डेटा दिखता है, तो यह dateRange एक दिन का हो सकता है. अगर CohortsRange में हर हफ़्ते के हिसाब से डेटा दिखता है, तो इस dateRange को हफ़्ते की सीमा के हिसाब से अलाइन किया जा सकता है. यह रविवार से शुरू होकर शनिवार को खत्म होता है. अगर CohortsRange में हर महीने के हिसाब से डेटा इकट्ठा किया जाता है, तो इस dateRange को महीने के हिसाब से अलाइन किया जा सकता है. इसकी शुरुआत महीने के पहले दिन से होती है और यह महीने के आखिरी दिन खत्म होता है.

CohortsRange

यह कुहॉर्ट रिपोर्ट के लिए, रिपोर्टिंग की तारीख की बढ़ी हुई सीमा को कॉन्फ़िगर करता है. यह एक ऑफ़सेट अवधि तय करता है, ताकि कोहॉर्ट को ट्रैक किया जा सके.

JSON के काेड में दिखाना
{
  "granularity": enum (Granularity),
  "startOffset": integer,
  "endOffset": integer
}
फ़ील्ड
granularity

enum (Granularity)

ज़रूरी है. एक जैसे उपयोगकर्ताओं के ग्रुप की रिपोर्ट के लिए, रिपोर्टिंग की तारीख की बढ़ी हुई सीमा के लिए startOffset और endOffset की व्याख्या करने के लिए इस्तेमाल की जाने वाली बारीकी.

startOffset

integer

startOffset, सदस्यता लेने वाले लोगों के ग्रुप की रिपोर्ट के लिए, रिपोर्टिंग की तारीख की बढ़ी हुई सीमा की शुरुआती तारीख तय करता है. startOffset को आम तौर पर 0 पर सेट किया जाता है, ताकि रिपोर्ट में एक जैसे उपयोगकर्ताओं के ग्रुप को हासिल करने के बाद का डेटा शामिल हो.

अगर granularity DAILY है, तो रिपोर्टिंग की तारीख की बढ़ी हुई सीमा का startDate, एक जैसे उपयोगकर्ताओं के ग्रुप का startDate प्लस startOffset दिन होता है.

अगर granularity WEEKLY है, तो रिपोर्टिंग की तारीख की बढ़ी हुई सीमा का startDate, एक जैसे उपयोगकर्ताओं के ग्रुप का startDate प्लस startOffset * 7 दिन होता है.

अगर granularity MONTHLY है, तो रिपोर्टिंग की तारीख की बढ़ी हुई सीमा का startDate, एक जैसे उपयोगकर्ताओं के ग्रुप का startDate प्लस startOffset * 30 दिन होता है.

endOffset

integer

ज़रूरी है. endOffset, किसी कोहॉर्ट रिपोर्ट के लिए, रिपोर्टिंग की तारीख की बढ़ी हुई सीमा के खत्म होने की तारीख तय करता है. endOffset कोई भी पॉज़िटिव पूर्णांक हो सकता है. हालांकि, आम तौर पर इसे 5 से 10 पर सेट किया जाता है, ताकि रिपोर्ट में अगले कई समय के लिए, कोहॉर्ट का डेटा शामिल हो.

अगर granularity DAILY है, तो रिपोर्टिंग की तारीख की बढ़ी हुई सीमा का endDate, एक जैसे उपयोगकर्ताओं के ग्रुप का endDate प्लस endOffset दिन होता है.

अगर granularity WEEKLY है, तो रिपोर्टिंग की तारीख की बढ़ी हुई सीमा का endDate, एक जैसे उपयोगकर्ताओं के ग्रुप का endDate प्लस endOffset * 7 दिन होता है.

अगर granularity MONTHLY है, तो रिपोर्टिंग की तारीख की बढ़ी हुई सीमा का endDate, एक जैसे उपयोगकर्ताओं के ग्रुप का endDate प्लस endOffset * 30 दिन होता है.

जानकारी का स्तर

एक जैसे उपयोगकर्ताओं के ग्रुप की रिपोर्ट के लिए, रिपोर्टिंग की तारीख की बढ़ी हुई सीमा के लिए startOffset और endOffset की व्याख्या करने के लिए इस्तेमाल की जाने वाली बारीकी.

Enums
GRANULARITY_UNSPECIFIED इसे कभी भी तय नहीं किया जाना चाहिए.
DAILY हर दिन के हिसाब से जानकारी. आम तौर पर, इसका इस्तेमाल तब किया जाता है, जब कोहॉर्ट का dateRange एक दिन का हो और अनुरोध में cohortNthDay शामिल हो.
WEEKLY हर हफ़्ते के हिसाब से डेटा. इसका इस्तेमाल आम तौर पर तब किया जाता है, जब कोहॉर्ट का dateRange एक हफ़्ते का हो (रविवार से शुरू होकर शनिवार को खत्म होने वाला हफ़्ता) और अनुरोध में cohortNthWeek शामिल हो.
MONTHLY महीने के हिसाब से जानकारी. इसका इस्तेमाल आम तौर पर तब किया जाता है, जब कोहॉर्ट का dateRange एक महीने का हो और अनुरोध में cohortNthMonth शामिल हो.

CohortReportSettings

एक जैसे उपयोगकर्ताओं के ग्रुप की रिपोर्ट की वैकल्पिक सेटिंग.

JSON के काेड में दिखाना
{
  "accumulate": boolean
}
फ़ील्ड
accumulate

boolean

अगर यह वैल्यू सही है, तो पहली बार इंटरैक्ट करने की तारीख से लेकर आखिरी तारीख तक के नतीजे इकट्ठा किए जाते हैं. RunReportRequest में काम नहीं करता.

SamplingLevel

अनुरोधों के लिए सैंपलिंग लेवल की कैटगरी.

Enums
SAMPLING_LEVEL_UNSPECIFIED टाइप की जानकारी नहीं दी गई है.
LOW यह स्टैंडर्ड प्रॉपर्टी के लिए, एक करोड़ का सैंपलिंग लेवल और Google Analytics 360 प्रॉपर्टी के लिए, 10 करोड़ का सैंपलिंग लेवल लागू करता है.
MEDIUM यह सुविधा, Google Analytics 360 प्रॉपर्टी के लिए उपलब्ध है. इसमें एक अरब तक के डेटा का सैंपल लिया जा सकता है.
UNSAMPLED यह सुविधा सिर्फ़ Google Analytics 360 प्रॉपर्टी के लिए उपलब्ध है. पूरे डेटा पर आधारित एक्सप्लोरेशन ज़्यादा सटीक होते हैं. साथ ही, इनसे ऐसी इनसाइट मिल सकती हैं जो स्टैंडर्ड एक्सप्लोरेशन में नहीं दिखतीं. ज़्यादा जानने के लिए, https://support.google.com/analytics/answer/10896953 पर जाएं.

ReportMetadata

किसी रिपोर्ट टास्क के लिए रिपोर्ट का मेटाडेटा.

JSON के काेड में दिखाना
{
  "creationQuotaTokensCharged": integer,
  "state": enum (State),
  "beginCreatingTime": string,
  "taskRowCount": integer,
  "errorMessage": string,
  "totalRowCount": integer
}
फ़ील्ड
creationQuotaTokensCharged

integer

सिर्फ़ आउटपुट के लिए. रिपोर्ट बनाते समय, कुल कितने कोटा टोकन का इस्तेमाल किया गया. टोकन की यह संख्या, CREATING स्थिति में की गई गतिविधि पर आधारित होती है. इसलिए, जब कोई रिपोर्ट टास्क ACTIVE या FAILED स्थिति में पहुंच जाता है, तो टोकन का यह शुल्क तय हो जाता है.

state

enum (State)

सिर्फ़ आउटपुट के लिए. रिपोर्ट से जुड़े इस टास्क की मौजूदा स्थिति.

beginCreatingTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. वह समय जब reportTasks.create को कॉल किया गया था और रिपोर्ट में CREATING स्थिति दिखने लगी थी.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".

taskRowCount

integer

सिर्फ़ आउटपुट के लिए. रिपोर्ट के नतीजे में मौजूद लाइनों की कुल संख्या. यह फ़ील्ड तब भरा जाएगा, जब स्थिति 'चालू है' पर सेट होगी. मौजूदा रिपोर्ट में पेज नंबर डालने के लिए, taskRowCount का इस्तेमाल किया जा सकता है.

errorMessage

string

सिर्फ़ आउटपुट के लिए. अगर रिपोर्ट बनाने के दौरान कोई टास्क पूरा नहीं होता है, तो गड़बड़ी का मैसेज दिखता है.

totalRowCount

integer

सिर्फ़ आउटपुट के लिए. Google Analytics स्टोरेज में मौजूद पंक्तियों की कुल संख्या. अगर आपको मौजूदा रिपोर्ट के अलावा, डेटा की अन्य लाइनों के बारे में क्वेरी करनी है, तो वे totalRowCount के आधार पर, रिपोर्ट से जुड़ा नया टास्क शुरू कर सकते हैं.

taskRowCount का मतलब है कि यह मौजूदा रिपोर्ट से जुड़ी लाइनों की संख्या दिखाता है. वहीं, totalRowCount का मतलब है कि यह Google Analytics स्टोरेज से वापस लाए गए सभी डेटा की लाइनों की कुल संख्या दिखाता है.

उदाहरण के लिए, मान लीजिए कि मौजूदा रिपोर्ट का taskRowCount 20 है. इसमें पहली 20 पंक्तियों का डेटा दिखता है. साथ ही, totalRowCount की वैल्यू 30 है. इसका मतलब है कि सभी 30 लाइनों के लिए डेटा मौजूद है. taskRowCount का इस्तेमाल, शुरुआती 20 लाइनों को पेज पर दिखाने के लिए किया जा सकता है. रिपोर्ट को बड़ा करने और उसमें सभी 30 लाइनों का डेटा शामिल करने के लिए, totalRowCount का इस्तेमाल करके एक नया रिपोर्ट टास्क बनाया जा सकता है. इससे 30 लाइनों के पूरे डेटा सेट को ऐक्सेस किया जा सकता है.

राज्य

प्रोसेसिंग की स्थिति.

Enums
STATE_UNSPECIFIED 'अनस्पेसिफ़ाइड' स्थिति का इस्तेमाल कभी नहीं किया जाएगा.
CREATING फ़िलहाल, रिपोर्ट बनाई जा रही है. यह आने वाले समय में उपलब्ध होगी. CreateReport कॉल करने के तुरंत बाद रिपोर्ट बन जाती है.
ACTIVE रिपोर्ट पूरी तरह से बन गई है और क्वेरी करने के लिए तैयार है.
FAILED रिपोर्ट नहीं बनाई जा सकी.

तरीके

create

यह रिपोर्ट बनाने का टास्क शुरू करता है.

get

इस तरीके से, किसी रिपोर्ट टास्क के बारे में रिपोर्ट मेटाडेटा मिलता है.

list

किसी प्रॉपर्टी के लिए, रिपोर्ट से जुड़े सभी टास्क की सूची बनाता है.

query

यह रिपोर्ट टास्क का कॉन्टेंट वापस लाता है.