REST Resource: properties.reportTasks

संसाधन: ReportTask

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

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

string

सिर्फ़ आउटपुट के लिए. आइडेंटिफ़ायर. रिपोर्ट टास्क संसाधन का नाम, बनाते समय असाइन किया गया. फ़ॉर्मैट: "property/{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
}
फ़ील्ड
dimensions[]

object (Dimension)

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

metrics[]

object (Metric)

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

dateRanges[]

object (DateRange)

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

dimensionFilter

object (FilterExpression)

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

metricFilter

object (FilterExpression)

ज़रूरी नहीं. मेट्रिक का फ़िल्टर क्लॉज़. एसक्यूएल की 'क्लॉज़' की तरह ही, रिपोर्ट की लाइनों को एग्रीगेट करने के बाद लागू किया जाता है. इस फ़िल्टर में आयाम का उपयोग नहीं किया जा सकता है.

offset

string (int64 format)

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

रिपोर्ट टास्क बनाते समय 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.

डाइमेंशन

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

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, ", ", शहर).

DimensionExpression

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

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, ", ", शहर).

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_]$ से मेल खाने चाहिए.

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

expression

string

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

invisible

boolean

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

DateRange

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

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

string

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

endDate

string

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

name

string

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

FilterExpression

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

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

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

object (FilterExpressionList)

andGroup में मौजूद फ़िल्टर एक्सप्रेशन के बीच AND संबंध होता है.

orGroup

object (FilterExpressionList)

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

notExpression

object (FilterExpression)

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

filter

object (Filter)

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

FilterExpressionList

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

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

object (FilterExpression)

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

फ़िल्टर

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

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

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // 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

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

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)

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

MetricAggregation

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

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

इससे ऑर्डर करें

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

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" < "क" < "X" < "ब" < "z".
CASE_INSENSITIVE_ALPHANUMERIC लोअर केस यूनिकोड कोड पॉइंट के हिसाब से, अक्षरों और अंकों से बने केस-इनसेंसिटिव. उदाहरण के लिए, "2" < "क" < "ब" < "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 में उपलब्ध नहीं है.

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

स्थिति

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

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

तरीके

create

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

get

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

list

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

query

रिपोर्ट में मौजूद किसी टास्क का कॉन्टेंट हासिल करता है.