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

ज़रूरी नहीं. आईएसओ4217 फ़ॉर्मैट में मुद्रा कोड, जैसे कि "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 तय किया गया है, तो name कोई भी ऐसी स्ट्रिंग हो सकती है जिसे वर्णों के तय किए गए सेट में शामिल किया गया हो. उदाहरण के लिए, अगर dimensionExpression, country और city को जोड़ता है, तो उस डाइमेंशन को countryAndCity कहा जा सकता है. चुने गए डाइमेंशन के नाम, रेगुलर एक्सप्रेशन ^[a-zA-Z0-9_]$ से मेल खाने चाहिए.

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

object (DimensionExpression)

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

DimensionExpression

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
DimensionExpression के लिए, डाइमेंशन एक्सप्रेशन का एक टाइप तय करें. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
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 तय किया गया है, तो 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 के काेड में दिखाना 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "andGroup": {
    object (FilterExpressionList)
  },
  "orGroup": {
    object (FilterExpressionList)
  },
  "notExpression": {
    object (FilterExpression)
  },
  "filter": {
    object (Filter)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
FilterExpression के लिए, फ़िल्टर एक्सप्रेशन का कोई एक टाइप तय करें. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
andGroup

object (FilterExpressionList)

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

object (FilterExpressionList)

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

object (FilterExpression)

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

object (Filter)

यह एक बेसिक फ़िल्टर है. एक ही फ़िल्टर एक्सप्रेशन में, फ़िल्टर के सभी फ़ील्ड के नाम या तो सभी डाइमेंशन या सभी मेट्रिक होने चाहिए.
एक-दूसरे से अलग फ़ील्ड के आखिर में.

FilterExpressionList

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

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

object (FilterExpression)

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

फ़िल्टर करें

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  },
  "emptyFilter": {
    object (EmptyFilter)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
fieldName

string

डाइमेंशन या मेट्रिक का नाम. यह डाइमेंशन या मेट्रिक में तय किया गया नाम होना चाहिए.
Filter के लिए, किसी एक तरह का फ़िल्टर तय करें. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
stringFilter

object (StringFilter)

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

object (InListFilter)

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

object (NumericFilter)

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

object (BetweenFilter)

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

object (EmptyFilter)

खाली वैल्यू के लिए फ़िल्टर, जैसे कि "(not set)" और "" वैल्यू.
एक-दूसरे से अलग फ़ील्ड के आखिर में.

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 के काेड में दिखाना 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "int64Value": string,
  "doubleValue": number
  // End of mutually exclusive fields.
}
फ़ील्ड
इनमें से कोई एक संख्यात्मक वैल्यू. यहां दिए गए फ़ील्ड, एक-दूसरे से अलग हैं. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
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 Count ऑपरेटर.

OrderBy

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "metric": {
    object (MetricOrderBy)
  },
  "dimension": {
    object (DimensionOrderBy)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
desc

boolean

अगर यह विकल्प चुना जाता है, तो डेटा को घटते क्रम में लगाया जाता है.
OrderBy के लिए, ऑर्डर करने का एक तरीका तय करें. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
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 यह स्टैंडर्ड प्रॉपर्टी के लिए, 1 करोड़ का सैंपलिंग लेवल और 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

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