Method: properties.runPivotReport

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

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

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

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

पाथ के पैरामीटर

पैरामीटर
property

string

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

उदाहरण: प्रॉपर्टीज़/1234

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

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

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

object (Dimension)

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

metrics[]

object (Metric)

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

dateRanges[]

object (DateRange)

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

pivots[]

object (Pivot)

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

dimensionFilter

object (FilterExpression)

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

metricFilter

object (FilterExpression)

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

currencyCode

string

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

cohortSpec

object (CohortSpec)

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

keepEmptyRows

boolean

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

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

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

returnPropertyQuota

boolean

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

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

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

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

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

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