- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति पाने के लिंक
- इसे आज़माएं!
डेटा ऐक्सेस रिकॉर्ड की कस्टमाइज़ की गई रिपोर्ट दिखाता है. इस रिपोर्ट में किसी उपयोगकर्ता के Google Analytics रिपोर्टिंग डेटा को हर बार पढ़ने का रिकॉर्ड मिलता है. ऐक्सेस के रिकॉर्ड दो साल तक सेव रखे जाते हैं.
किसी प्रॉपर्टी के लिए, डेटा ऐक्सेस रिपोर्ट का अनुरोध किया जा सकता है. किसी भी प्रॉपर्टी के लिए रिपोर्ट का अनुरोध किया जा सकता है. हालांकि, कोटे से जुड़े नहीं होने वाले डाइमेंशन का अनुरोध सिर्फ़ Google Analytics 360 प्रॉपर्टी के लिए किया जा सकता है. यह तरीका सिर्फ़ एडमिन के लिए उपलब्ध है.
डेटा ऐक्सेस करने के इन रिकॉर्ड में GA4 यूज़र इंटरफ़ेस (यूआई) रिपोर्टिंग, GA4 यूज़र इंटरफ़ेस (यूआई) एक्सप्लोरेशन, GA4 डेटा एपीआई, और Firebase और AdMob जैसे अन्य प्रॉडक्ट शामिल हैं. ये प्रॉडक्ट, लिंकेज की मदद से Google Analytics से डेटा हासिल कर सकते हैं. इन रिकॉर्ड में, प्रॉपर्टी के कॉन्फ़िगरेशन में किए गए बदलाव शामिल नहीं होते. जैसे, कोई स्ट्रीम जोड़ना या प्रॉपर्टी का टाइम ज़ोन बदलना. कॉन्फ़िगरेशन में हुए बदलाव का इतिहास देखने के लिए, searchChangeHistoryEvents देखें.
एचटीटीपी अनुरोध
POST https://analyticsadmin.googleapis.com/v1beta/{entity=properties/*}:runAccessReport
यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
entity |
डेटा ऐक्सेस रिपोर्ट में, प्रॉपर्टी लेवल या खाता लेवल पर अनुरोध करने की सुविधा उपलब्ध है. अगर खाता लेवल पर अनुरोध किया जाता है, तो डेटा ऐक्सेस रिपोर्ट में उस खाते की सभी प्रॉपर्टी का पूरा ऐक्सेस शामिल होता है. प्रॉपर्टी लेवल पर अनुरोध करने के लिए, इकाई को 'properties/123' होना चाहिए. उदाहरण के लिए, अगर "123" आपका GA4 प्रॉपर्टी आईडी है. खाता लेवल पर अनुरोध करने के लिए, इकाई को 'accounts/1234' होना चाहिए. उदाहरण के लिए, अगर "1234" आपका GA4 खाता आईडी है. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में, नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:
JSON के काेड में दिखाना |
---|
{ "dimensions": [ { object ( |
फ़ील्ड | |
---|---|
dimensions[] |
अनुरोध किए गए डाइमेंशन और जवाब में दिखाए गए. अनुरोधों में ज़्यादा से ज़्यादा नौ डाइमेंशन शामिल किए जा सकते हैं. |
metrics[] |
वे मेट्रिक जिनका अनुरोध किया गया है और जो जवाब में दिखाई गई हैं. ज़्यादा से ज़्यादा 10 मेट्रिक के लिए अनुरोध किए जा सकते हैं. |
dateRanges[] |
ऐक्सेस रिकॉर्ड की तारीख की सीमाएं, जिन्हें पढ़ना है. अगर तारीख की एक से ज़्यादा सीमाओं का अनुरोध किया जाता है, तो हर रिस्पॉन्स लाइन में, तारीख की सीमा का शून्य आधार वाला इंडेक्स शामिल होगा. अगर तारीख की दो सीमाएं ओवरलैप होती हैं, तो ओवरलैप होने वाले दिनों के ऐक्सेस रिकॉर्ड, तारीख की दोनों सीमाओं के लिए रिस्पॉन्स की पंक्तियों में शामिल किए जाते हैं. तारीख की दो सीमा तक अनुरोध किए जा सकते हैं. |
dimensionFilter |
डाइमेंशन फ़िल्टर की मदद से, रिपोर्ट के जवाब को फ़िल्टर से मैच करने वाली खास डाइमेंशन वैल्यू तक सीमित किया जा सकता है. उदाहरण के लिए, किसी एक उपयोगकर्ता के ऐक्सेस रिकॉर्ड के हिसाब से फ़िल्टर करना. ज़्यादा जानने के लिए, उदाहरणों के लिए डाइमेंशन फ़िल्टर के बुनियादी सिद्धांत देखें. इस फ़िल्टर में मेट्रिक का इस्तेमाल नहीं किया जा सकता. |
metricFilter |
मेट्रिक फ़िल्टर की मदद से, फ़िल्टर से मैच करने वाली चुनिंदा मेट्रिक वैल्यू के लिए ही रिपोर्ट का रिस्पॉन्स दिया जा सकता है. मेट्रिक फ़िल्टर, रिपोर्ट की लाइनों को एग्रीगेट करने के बाद लागू किए जाते हैं. यह SQL having-clause की तरह ही होता है. इस फ़िल्टर में डाइमेंशन का इस्तेमाल नहीं किया जा सकता. |
offset |
शुरुआती पंक्ति की पंक्तियों की संख्या. पहली पंक्ति को पंक्ति 0 माना जाता है. अगर ऑफ़सेट की वैल्यू नहीं दी जाती है, तो उसे 0 माना जाता है. अगर ऑफ़सेट शून्य है, तो यह तरीका पेजेशन पैरामीटर के बारे में ज़्यादा जानने के लिए, पेजेशन देखें. |
limit |
कितनी पंक्तियां लौटानी हैं, इसे बताने वाली संख्या. अगर कोई वैल्यू नहीं दी जाती है, तो 10,000 पंक्तियां दिखती हैं. एपीआई हर अनुरोध के लिए ज़्यादा से ज़्यादा 1,00,000 लाइनें दिखाता है. भले ही, आपने कितनी भी लाइनें मांगी हों. अगर पेजेशन पैरामीटर के बारे में ज़्यादा जानने के लिए, पेजेशन देखें. |
timeZone |
अगर इस अनुरोध के लिए टाइम ज़ोन की जानकारी दी गई है, तो वह. अगर टाइम ज़ोन की जानकारी नहीं दी गई है, तो प्रॉपर्टी के टाइम ज़ोन का इस्तेमाल किया जाता है. अनुरोध के टाइम ज़ोन का इस्तेमाल, रिपोर्ट की शुरुआत और खत्म होने की तारीखों को समझने के लिए किया जाता है. इन्हें IANA टाइम ज़ोन डेटाबेस (https://www.iana.org/time-zones) से स्ट्रिंग के तौर पर फ़ॉर्मैट किया जाता है. जैसे, "America/New_York" या "Asia/Tokyo". |
orderBys[] |
इससे पता चलता है कि जवाब में पंक्तियों को किस क्रम में लगाया गया है. |
returnEntityQuota |
इस Analytics प्रॉपर्टी के कोटे की मौजूदा स्थिति दिखाने के लिए टॉगल करें. कोटा, AccessQuota की जानकारी में शामिल होता है. खाता-लेवल के अनुरोधों के लिए, यह फ़ील्ड 'गलत' होना चाहिए. |
includeAllUsers |
ज़रूरी नहीं. इससे यह तय होता है कि जवाब में उन उपयोगकर्ताओं को शामिल करना है या नहीं जिन्होंने कभी एपीआई कॉल नहीं किया है. अगर सही है, तो किसी खास प्रॉपर्टी या खाते का ऐक्सेस रखने वाले सभी उपयोगकर्ताओं को रिस्पॉन्स में शामिल किया जाता है. इससे कोई फ़र्क़ नहीं पड़ता कि उन्होंने एपीआई कॉल किया है या नहीं. गलत होने पर, सिर्फ़ एपीआई कॉल करने वाले उपयोगकर्ताओं को ही शामिल किया जाएगा. |
expandGroups |
ज़रूरी नहीं. यह तय करता है कि उपयोगकर्ताओं को उपयोगकर्ता ग्रुप में वापस लाया जाए या नहीं. यह फ़ील्ड सिर्फ़ तब काम करता है, जब includeAllUsers को 'सही है' पर सेट किया गया हो. अगर सही है, तो यह किसी प्रॉपर्टी या खाते के ऐक्सेस वाले सभी उपयोगकर्ताओं को दिखाएगा. अगर यह पैरामीटर 'गलत' पर सेट है, तो सिर्फ़ उन उपयोगकर्ताओं की जानकारी दिखेगी जिनके पास सीधे ऐक्सेस है. |
जवाब का मुख्य भाग
कामयाब रहने पर, जवाब के मुख्य हिस्से में RunAccessReportResponse
का एक इंस्टेंस शामिल किया जाता है.
अनुमति के दायरे
इसके लिए, OAuth के इनमें से किसी एक स्कोप की ज़रूरत होती है:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics.edit