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)

ज़रूरी नहीं. मेट्रिक का एग्रीगेशन. एग्रीगेट की गई मेट्रिक वैल्यू उन पंक्तियों में दिखेंगी जहां डाइमेंशन वैल्यू "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 के काेड में दिखाना 
{

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

डाइमेंशन या मेट्रिक फ़िल्टर दिखाने के लिए. एक ही 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)

andGroup में मौजूद FilterExpressions में AND संबंध होता है.
orGroup

object (FilterExpressionList)

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

object (FilterExpression)

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

object (Filter)

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

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 क्रम से लगाने से पहले, डाइमेंशन वैल्यू को संख्याओं में बदल दिया जाता है. उदाहरण के लिए, 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 स्टैंडर्ड प्रॉपर्टी के लिए सैंपलिंग लेवल 10 करोड़ और 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 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
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

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