- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- RunReportRequest
- इसे आज़माएं!
बैच में कई रिपोर्ट दिखाता है. सभी रिपोर्ट एक ही GA4 प्रॉपर्टी के लिए होनी चाहिए.
एचटीटीपी अनुरोध
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:batchRunReports
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
property |
वह Google Analytics GA4 प्रॉपर्टी आइडेंटिफ़ायर जिसके इवेंट ट्रैक किए जाते हैं. यूआरएल पाथ में बताया गया हो, मुख्य हिस्से में नहीं. ज़्यादा जानने के लिए, देखें कि प्रॉपर्टी आईडी कहां मिलेगा. बैच के लिए यह प्रॉपर्टी ज़रूरी है. RunreportRequest में मौजूद प्रॉपर्टी, तय नहीं की गई है या इस प्रॉपर्टी से मेल खा सकती है. उदाहरण: प्रॉपर्टीज़/1234 |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{
"requests": [
{
object ( |
फ़ील्ड | |
---|---|
requests[] |
अलग-अलग अनुरोध. हर अनुरोध की रिपोर्ट का अलग जवाब होता है. एक साथ कई अनुरोध किए जा सकते हैं. इसके लिए, ज़्यादा से ज़्यादा पांच अनुरोध किए जा सकते हैं. |
जवाब का मुख्य भाग
कई रिपोर्ट वाला बैच रिस्पॉन्स.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"reports": [
{
object ( |
फ़ील्ड | |
---|---|
reports[] |
अलग-अलग जवाब. हर जवाब के लिए अलग रिपोर्ट अनुरोध होता है. |
kind |
यह बताता है कि यह मैसेज किस तरह का संसाधन है. यह |
अनुमति के दायरे
इनमें से किसी एक OAuth दायरों की ज़रूरत होती है:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
RunReportRequest
रिपोर्ट जनरेट करने का अनुरोध.
जेएसओएन के काेड में दिखाना |
---|
{ "property": string, "dimensions": [ { object ( |
फ़ील्ड | |
---|---|
property |
वह Google Analytics GA4 प्रॉपर्टी आइडेंटिफ़ायर जिसके इवेंट ट्रैक किए जाते हैं. यूआरएल पाथ में बताया गया हो, मुख्य हिस्से में नहीं. ज़्यादा जानने के लिए, देखें कि प्रॉपर्टी आईडी कहां मिलेगा. बैच अनुरोध में, यह प्रॉपर्टी या तो तय नहीं की गई है या बैच-लेवल की प्रॉपर्टी के साथ मेल खानी चाहिए. उदाहरण: प्रॉपर्टीज़/1234 |
dimensions[] |
अनुरोध किए गए और दिखाए गए डाइमेंशन. |
metrics[] |
अनुरोध की गई और दिखाई गई मेट्रिक. |
dateRanges[] |
पढ़ने के लिए तारीख की सीमाएं. अगर तारीख की एक से ज़्यादा सीमाओं का अनुरोध किया जाता है, तो जवाब वाली हर लाइन में, तारीख की सीमा का इंडेक्स शून्य पर आधारित होगा. अगर तारीख की दो सीमाएं ओवरलैप होती हैं, तो ओवरलैप होने वाले दिनों का इवेंट डेटा, दोनों तारीख की सीमाओं के लिए जवाब की लाइनों में शामिल कर दिया जाता है. एक जैसे उपयोगकर्ताओं के ग्रुप के अनुरोध में, |
dimensionFilter |
डाइमेंशन फ़िल्टर की मदद से, रिपोर्ट में सिर्फ़ खास डाइमेंशन वैल्यू के लिए अनुरोध किया जा सकता है. ज़्यादा जानकारी के लिए, डाइमेंशन फ़िल्टर की बुनियादी बातें देखें. इस फ़िल्टर में मेट्रिक का इस्तेमाल नहीं किया जा सकता. |
metricFilter |
मेट्रिक का फ़िल्टर क्लॉज़. रिपोर्ट की पंक्तियों को इकट्ठा करने के बाद लागू किया जाता है. यह एसक्यूएल के क्लॉज़ की तरह ही होता है. इस फ़िल्टर में डाइमेंशन का इस्तेमाल नहीं किया जा सकता. |
offset |
शुरुआती पंक्ति के लिए पंक्तियों की संख्या. पहली लाइन की गिनती पंक्ति 0 के तौर पर की जाती है. पेजिंग करते समय, पहला अनुरोध ऑफ़सेट तय नहीं करता है; या इसके बराबर, ऑफ़सेट को 0 पर सेट करता है; पहला अनुरोध पंक्तियों का पहली पेज पर नंबर डालने वाले इस पैरामीटर के बारे में ज़्यादा जानने के लिए, पेज पर नंबर डालना देखें. |
limit |
दिखाई जाने वाली पंक्तियों की संख्या. इन्हें तय न करने पर, 10,000 लाइनें दिखती हैं. एपीआई हर अनुरोध में ज़्यादा से ज़्यादा 2,50,000 लाइनें दिखाता है, चाहे आपने कितनी भी लाइनें मांगी हों. अगर पेज पर नंबर डालने वाले इस पैरामीटर के बारे में ज़्यादा जानने के लिए, पेज पर नंबर डालना देखें. |
metricAggregations[] |
मेट्रिक का एग्रीगेशन. एग्रीगेट की गई मेट्रिक वैल्यू उन लाइनों में दिखेंगी जहां डाइमेंशन वैल्यू "RESERVED_(Metricएग्रीगेशन)" पर सेट होती हैं. |
orderBys[] |
इससे पता चलता है कि रिस्पॉन्स में पंक्तियों को किस क्रम में लगाया जाता है. |
currencyCode |
ISO4217 फ़ॉर्मैट में मुद्रा कोड, जैसे कि "AED", "USD", "JPY". अगर फ़ील्ड खाली है, तो रिपोर्ट में प्रॉपर्टी के लिए डिफ़ॉल्ट मुद्रा का इस्तेमाल किया जाता है. |
cohortSpec |
इस अनुरोध से जुड़ा, एक जैसे उपयोगकर्ताओं का ग्रुप. अगर अनुरोध में कोई समानता रखने वाले समूह है, तो 'समानता रखने वाले लोग' डाइमेंशन मौजूद होना चाहिए. |
keepEmptyRows |
अगर 'गलत है' या इसकी वैल्यू नहीं दी गई है, तो हर लाइन, 0 के बराबर सभी मेट्रिक नहीं दिखेगी. अगर वैल्यू सही है, तो ये लाइनें तब दिखेंगी, जब उन्हें किसी फ़िल्टर का इस्तेमाल करके अलग से नहीं हटाया जाएगा.
उदाहरण के लिए, अगर कोई प्रॉपर्टी कभी भी |
returnPropertyQuota |
इस Analytics प्रॉपर्टी के कोटा की मौजूदा स्थिति दिखाने या न दिखाने के लिए टॉगल करता है. कोटा को PropertyQuota के तौर पर दिखाया जाता है. |
comparisons[] |
ज़रूरी नहीं. तुलनाओं का अनुरोध किया गया और दिखाया गया कॉन्फ़िगरेशन. जवाब में तुलना वाला कॉलम पाने के लिए, सिर्फ़ तुलना वाले फ़ील्ड की ज़रूरत होती है. |