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)

अनुरोध की गई मेट्रिक, कम से कम एक मेट्रिक के बारे में बताना ज़रूरी है. तय की गई सभी मेट्रिक का इस्तेमाल इनमें से किसी एक के लिए किया जाना चाहिए: मेट्रिक_expression, मेट्रिकफ़िल्टर, ऑर्डर से जुड़ा हुआ.
dateRanges[]

object (DateRange)

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

object (Pivot)

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

object (FilterExpression)

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

object (FilterExpression)

मेट्रिक का फ़िल्टर क्लॉज़. पोस्ट एग्रीगेशन फ़ेज़ में लागू किया जाता है. यह एसक्यूएल के क्लॉज़ की तरह ही होता है. इस फ़िल्टर में मेट्रिक का इस्तेमाल करने के लिए अनुरोध करना ज़रूरी है. इस फ़िल्टर में डाइमेंशन का इस्तेमाल नहीं किया जा सकता.
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