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