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 तय किया गया है, तो 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)

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,

  // 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

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

खाली वैल्यू के लिए फ़िल्टर करें. यह फ़िल्टर, "" या (not set) वैल्यू वाली डाइमेंशन वैल्यू से मेल खाता है. इस फ़िल्टर का इस्तेमाल करके, उन लाइनों का पता लगाया जा सकता है जिनमें डाइमेंशन वैल्यू मौजूद नहीं हैं या भरी नहीं गई हैं. इसके अलावा, इसे notExpression के साथ मिलाकर, इन लाइनों को रिपोर्ट से हटाया जा सकता है. इसके लिए, "" और (not set), दोनों के लिए अलग-अलग फ़िल्टर करने की ज़रूरत नहीं होती.

MetricAggregation

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

Enums
METRIC_AGGREGATION_UNSPECIFIED ऑपरेटर की जानकारी नहीं दी गई है.
TOTAL SUM ऑपरेटर.
MINIMUM कम से कम ऑपरेटर.
MAXIMUM ज़्यादा से ज़्यादा ऑपरेटर.
COUNT COUNT ऑपरेटर.

OrderBy

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

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 प्रॉपर्टी के लिए उपलब्ध है. इसमें सैंपलिंग का लेवल 100 करोड़ होता है.
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

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