Method: properties.runPivotReport

यह आपके Google Analytics इवेंट डेटा की मनमुताबिक पिवट रिपोर्ट दिखाता है. पिवट रिपोर्ट, सामान्य रिपोर्ट के मुकाबले ज़्यादा बेहतर और जानकारी देने वाले फ़ॉर्मैट में होती हैं. पिवट रिपोर्ट में, डाइमेंशन सिर्फ़ तब दिखते हैं, जब उन्हें पिवट में शामिल किया जाता है. अपने डेटा को और भी बेहतर तरीके से समझने के लिए, एक से ज़्यादा पिवट तय किए जा सकते हैं.

एचटीटीपी अनुरोध

POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runPivotReport

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
property

string

यह Google Analytics की किसी प्रॉपर्टी का आइडेंटिफ़ायर है, जिसके इवेंट ट्रैक किए जाते हैं. यह यूआरएल पाथ में तय किया जाता है, न कि मुख्य हिस्से में. ज़्यादा जानने के लिए, प्रॉपर्टी आईडी कहां ढूंढें लेख पढ़ें. बैच अनुरोध में, इस प्रॉपर्टी को या तो तय नहीं किया जाना चाहिए या इसे बैच-लेवल की प्रॉपर्टी के मुताबिक होना चाहिए.

उदाहरण: properties/1234

अनुरोध का मुख्य हिस्सा

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "pivots": [
    {
      object (Pivot)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean,
  "comparisons": [
    {
      object (Comparison)
    }
  ]
}
फ़ील्ड
dimensions[]

object (Dimension)

अनुरोध किए गए डाइमेंशन. तय किए गए सभी डाइमेंशन का इस्तेमाल, इनमें से किसी एक के लिए किया जाना चाहिए: dimensionExpression, dimensionFilter, pivots, orderBys.
metrics[]

object (Metric)

अनुरोध की गई मेट्रिक. कम से कम एक मेट्रिक तय की जानी चाहिए. तय की गई सभी मेट्रिक का इस्तेमाल, इनमें से किसी एक के लिए किया जाना चाहिए: metric_expression, metricFilter, orderBys.
dateRanges[]

object (DateRange)

रिपोर्ट के लिए इवेंट डेटा पाने की तारीख की सीमा. अगर तारीख की एक से ज़्यादा सीमाएं तय की जाती हैं, तो रिपोर्ट में हर तारीख की सीमा का इवेंट डेटा इस्तेमाल किया जाता है. पिवट के फ़ील्ड के नामों में, "dateRange" फ़ील्ड के नाम वाला एक खास डाइमेंशन शामिल किया जा सकता है. अगर इसे शामिल किया जाता है, तो रिपोर्ट में तारीख की सीमाओं के बीच तुलना की जाती है. कोहॉर्ट अनुरोध में, इस dateRanges को तय नहीं किया जाना चाहिए.
pivots[]

object (Pivot)

यह कॉलम या लाइनों में, रिपोर्ट के डाइमेंशन के विज़ुअल फ़ॉर्मैट के बारे में बताता है. सभी पिवट में, fieldNames (डाइमेंशन के नाम) का यूनियन, डाइमेंशन में तय किए गए डाइमेंशन के नामों का सबसेट होना चाहिए. कोई भी दो पिवट, एक डाइमेंशन शेयर नहीं कर सकते. कोई डाइमेंशन सिर्फ़ तब दिखता है, जब वह पिवट में दिखता है.
dimensionFilter

object (FilterExpression)

डाइमेंशन का फ़िल्टर क्लॉज़. इस फ़िल्टर में इस्तेमाल करने के लिए, डाइमेंशन का अनुरोध किया जाना चाहिए. इस फ़िल्टर में मेट्रिक का इस्तेमाल नहीं किया जा सकता.
metricFilter

object (FilterExpression)

मेट्रिक का फ़िल्टर क्लॉज़. यह पोस्ट एग्रीगेशन फ़ेज़ पर लागू होता है. यह SQL के having-clause जैसा होता है. इस फ़िल्टर में इस्तेमाल करने के लिए, मेट्रिक का अनुरोध किया जाना चाहिए. इस फ़िल्टर में डाइमेंशन का इस्तेमाल नहीं किया जा सकता.
currencyCode

string

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

object (CohortSpec)

इस अनुरोध से जुड़ा कोहॉर्ट ग्रुप. अगर अनुरोध में कोई कोहॉर्ट ग्रुप है, तो 'कोहॉर्ट' डाइमेंशन मौजूद होना चाहिए.
keepEmptyRows

boolean

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

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

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

boolean

इससे यह तय होता है कि Google Analytics की इस प्रॉपर्टी के मौजूदा कोटे की जानकारी दिखाई जाए या नहीं. कोटा, PropertyQuota में दिखाया जाता है.
comparisons[]

object (Comparison)

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

जवाब का मुख्य हिस्सा

कामयाब रहने पर, जवाब के मुख्य हिस्से में RunPivotReportResponse का एक इंस्टेंस शामिल किया जाता है.

अनुमति के दायरे

इसके लिए, इनमें से किसी एक OAuth अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics