Method: runPivotReport

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

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

POST https://analyticsdata.googleapis.com/v1alpha:runPivotReport

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

अनुरोध का मुख्य भाग

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

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

object (Entity)

ऐसी प्रॉपर्टी जिसके इवेंट ट्रैक किए जाते हैं. बैच में किए गए अनुरोध में, इस इकाई की जानकारी नहीं होनी चाहिए या यह बैच-लेवल की इकाई के साथ मेल खाना चाहिए.

dimensions[]

object (Dimension)

अनुरोध किए गए डाइमेंशन. तय किए गए सभी डाइमेंशन का इस्तेमाल इनमें से किसी एक के लिए किया जाना चाहिए: डाइमेंशनएक्सप्रेशन, डाइमेंशन फ़िल्टर, पिवट, ऑर्डर बाय.

metrics[]

object (Metric)

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

dimensionFilter

object (FilterExpression)

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

metricFilter

object (FilterExpression)

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

pivots[]

object (Pivot)

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

dateRanges[]

object (DateRange)

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

currencyCode

string

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

cohortSpec

object (CohortSpec)

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

keepEmptyRows

boolean

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

returnPropertyQuota

boolean

यह टॉगल करता है कि इस Analytics प्रॉपर्टी के कोटा की मौजूदा स्थिति को लौटाना है या नहीं. कोटा की जानकारी, PropertyQuota से दी जाती है.

जवाब का मुख्य भाग

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

अनुमति पाने के लिंक

इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

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