REST Resource: properties.reportTasks

संसाधन: ReportTask

रिपोर्ट का खास कॉन्फ़िगरेशन.

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

string

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

object (ReportDefinition)

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

object (ReportMetadata)

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

ReportDefinition

किसी रिपोर्ट को चलाने के तरीके की परिभाषा.

जेएसओएन के काेड में दिखाना 
{
  "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
}
फ़ील्ड
dimensions[]

object (Dimension)

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

object (Metric)

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

object (DateRange)

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

object (FilterExpression)

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

object (FilterExpression)

ज़रूरी नहीं. मेट्रिक का फ़िल्टर क्लॉज़. रिपोर्ट की पंक्तियों को इकट्ठा करने के बाद लागू किया जाता है. यह एसक्यूएल के क्लॉज़ की तरह ही होता है. इस फ़िल्टर में डाइमेंशन का इस्तेमाल नहीं किया जा सकता.
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_(Metricएग्रीगेशन)" पर सेट होती हैं.
orderBys[]

object (OrderBy)

ज़रूरी नहीं. इससे पता चलता है कि रिस्पॉन्स में पंक्तियों को किस क्रम में लगाया जाता है.
currencyCode

string

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

object (CohortSpec)

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

boolean

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

keepEmptyRows सेटिंग चाहे जो हो, सिर्फ़ Google Analytics (GA4) प्रॉपर्टी से रिकॉर्ड किया गया डेटा ही रिपोर्ट में दिखाया जा सकता है.

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

डाइमेंशन

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

जेएसओएन के काेड में दिखाना 
{
  "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)

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

DimensionExpression

इसका इस्तेमाल डाइमेंशन को दिखाने के लिए किया जाता है. यह डाइमेंशन, कई डाइमेंशन के फ़ॉर्मूले का नतीजा होता है. इस्तेमाल के उदाहरण: 1) लोअरकेस(डाइमेंशन) 2) स्ट्रिंग जोड़ें(डाइमेंशन1, सिंबल, डाइमेंशन2).

जेएसओएन के काेड में दिखाना 
{

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

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

CaseExpression

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

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

string

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

ConcatenateExpression

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

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

string

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

string

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

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

मेट्रिक

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

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

string

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

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

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

string

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

boolean

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

DateRange

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

जेएसओएन के काेड में दिखाना 
{
  "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

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

जेएसओएन के काेड में दिखाना 
{

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

&Group में फ़िल्टर एक्सप्रेशन में AND का संबंध होता है.
orGroup

object (FilterExpressionList)

orGroup में फ़िल्टर एक्सप्रेशन का संबंध OR संबंध है.
notExpression

object (FilterExpression)

फ़िल्टर एक्सप्रेशन, notExpression का नहीं है.
filter

object (Filter)

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

FilterExpressionList

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

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

object (FilterExpression)

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

फ़िल्टर करें

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

जेएसओएन के काेड में दिखाना 
{
  "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)
  }
  // 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)

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

StringFilter

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

जेएसओएन के काेड में दिखाना 
{
  "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

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

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

string

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

boolean

सही होने पर, स्ट्रिंग की वैल्यू केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होती है.

NumericFilter

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

जेएसओएन के काेड में दिखाना 
{
  "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

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

जेएसओएन के काेड में दिखाना 
{

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

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

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

object (NumericValue)

इस संख्या से शुरू होता है.
toValue

object (NumericValue)

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

MetricAggregation

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

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

OrderBy

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

जेएसओएन के काेड में दिखाना 
{
  "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

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

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

string

अनुरोध करने के लिए इस्तेमाल किया गया मेट्रिक का नाम.

DimensionOrderBy

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

जेएसओएन के काेड में दिखाना 
{
  "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 मेट्रिक से कैलकुलेट किया जा सकता है. साथ ही, रिपोर्ट में इन दो अलग-अलग लाइनों का इस्तेमाल किया जाता है.

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

object (Cohort)

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

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

object (CohortsRange)

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

object (CohortReportSettings)

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

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

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

जेएसओएन के काेड में दिखाना 
{
  "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

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

जेएसओएन के काेड में दिखाना 
{
  "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

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

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

boolean

सही होने पर, पहले टच दिन से लेकर आखिरी दिन तक के नतीजे इकट्ठा करता है. RunReportRequest में उपलब्ध नहीं है.

ReportMetadata

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

जेएसओएन के काेड में दिखाना 
{
  "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 स्थिति शुरू हुई थी.

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड का रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक हो सकते हैं. उदाहरण: "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 लाइनों का डेटा शामिल करने के लिए, कुलRowCount का इस्तेमाल करके एक नया रिपोर्ट टास्क बनाया जा सकता है, ताकि 30 लाइनों के डेटा के पूरे सेट को ऐक्सेस किया जा सके.

स्थिति

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

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

तरीके

create

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

get

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

list

 यह प्रॉपर्टी के सभी रिपोर्ट टास्क की सूची बनाता है.

query

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