इस पेज का अनुवाद Cloud Translation API से किया गया है.

Method: properties.runAccessReport

एचटीटीपी अनुरोध
पाथ पैरामीटर
अनुरोध का मुख्य हिस्सा
- JSON फ़ॉर्मैट में दिखाना
जवाब का मुख्य हिस्सा
अनुमति के दायरे
इसे आज़माएं!

डेटा ऐक्सेस रिकॉर्ड की कस्टमाइज़ की गई रिपोर्ट दिखाता है. रिपोर्ट में, उपयोगकर्ता के Google Analytics के रिपोर्टिंग डेटा को जितनी बार भी पढ़ा जाता है उसका रिकॉर्ड मिलता है. ऐक्सेस का रिकॉर्ड दो साल तक रखा जाता है.

किसी प्रॉपर्टी के लिए, डेटा ऐक्सेस करने की रिपोर्ट का अनुरोध किया जा सकता है. प्रॉपर्टी, Google Analytics 360 में होनी चाहिए. यह तरीका सिर्फ़ एडमिन के लिए उपलब्ध है.

डेटा ऐक्सेस के इन रिकॉर्ड में, GA4 यूज़र इंटरफ़ेस (यूआई) रिपोर्टिंग, GA4 यूज़र इंटरफ़ेस (यूआई) एक्सप्लोरेशन, GA4 Data API, और Firebase और AdMob जैसे दूसरे प्रॉडक्ट शामिल हैं. ये प्रॉडक्ट, लिंकेज की मदद से Google Analytics से डेटा हासिल कर सकते हैं. इन रिकॉर्ड में, प्रॉपर्टी के कॉन्फ़िगरेशन में किए गए बदलाव शामिल नहीं होते. जैसे, स्ट्रीम जोड़ना या प्रॉपर्टी का टाइम ज़ोन बदलना. कॉन्फ़िगरेशन में बदलाव का इतिहास देखने के लिए, searchChangehistoryEvents देखें.

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

POST https://analyticsadmin.googleapis.com/v1alpha/{entity=properties/*}:runAccessReport

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

पाथ पैरामीटर

पैरामीटर

पैरामीटर
`entity`	`string` डेटा ऐक्सेस रिपोर्ट से, प्रॉपर्टी लेवल या खाता लेवल पर अनुरोध किया जा सकता है. अगर खाता लेवल पर अनुरोध किया जाता है, तो डेटा ऐक्सेस करने की रिपोर्ट में उस खाते की सभी प्रॉपर्टी का ऐक्सेस शामिल होता है. प्रॉपर्टी लेवल पर अनुरोध करने के लिए, इकाई का नाम 'property/123' जैसा होना चाहिए. हालांकि, अगर "123" आपकी GA4 प्रॉपर्टी का आईडी है, तो उसे इस तरह लिखें. खाता लेवल पर अनुरोध करने के लिए, इकाई का नाम 'accounts/1234' होना चाहिए. हालांकि, अगर आपका GA4 खाता आईडी "1234" है, तो उसे इस तरह लिखें.

entity

string

डेटा ऐक्सेस रिपोर्ट से, प्रॉपर्टी लेवल या खाता लेवल पर अनुरोध किया जा सकता है. अगर खाता लेवल पर अनुरोध किया जाता है, तो डेटा ऐक्सेस करने की रिपोर्ट में उस खाते की सभी प्रॉपर्टी का ऐक्सेस शामिल होता है.

प्रॉपर्टी लेवल पर अनुरोध करने के लिए, इकाई का नाम 'property/123' जैसा होना चाहिए. हालांकि, अगर "123" आपकी GA4 प्रॉपर्टी का आईडी है, तो उसे इस तरह लिखें. खाता लेवल पर अनुरोध करने के लिए, इकाई का नाम 'accounts/1234' होना चाहिए. हालांकि, अगर आपका GA4 खाता आईडी "1234" है, तो उसे इस तरह लिखें.

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

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

जेएसओएन के काेड में दिखाना

जेएसओएन के काेड में दिखाना
{ "dimensions": [ { object (`AccessDimension`) } ], "metrics": [ { object (`AccessMetric`) } ], "dateRanges": [ { object (`AccessDateRange`) } ], "dimensionFilter": { object (`AccessFilterExpression`) }, "metricFilter": { object (`AccessFilterExpression`) }, "offset": string, "limit": string, "timeZone": string, "orderBys": [ { object (`AccessOrderBy`) } ], "returnEntityQuota": boolean, "includeAllUsers": boolean, "expandGroups": boolean }

{
  "dimensions": [
    {
      object (AccessDimension)
    }
  ],
  "metrics": [
    {
      object (AccessMetric)
    }
  ],
  "dateRanges": [
    {
      object (AccessDateRange)
    }
  ],
  "dimensionFilter": {
    object (AccessFilterExpression)
  },
  "metricFilter": {
    object (AccessFilterExpression)
  },
  "offset": string,
  "limit": string,
  "timeZone": string,
  "orderBys": [
    {
      object (AccessOrderBy)
    }
  ],
  "returnEntityQuota": boolean,
  "includeAllUsers": boolean,
  "expandGroups": boolean
}

फ़ील्ड
`dimensions[]`	`object (AccessDimension)` जवाब में अनुरोध किए गए और दिखाए गए डाइमेंशन. अनुरोध ज़्यादा से ज़्यादा नौ डाइमेंशन के लिए जा सकते हैं.
`metrics[]`	`object (AccessMetric)` अनुरोध के जवाब में और दिखाई गई मेट्रिक. अनुरोध में ज़्यादा से ज़्यादा 10 मेट्रिक शामिल की जा सकती हैं.
`dateRanges[]`	`object (AccessDateRange)` पढ़ने के लिए ऐक्सेस रिकॉर्ड की तारीख की सीमाएं. अगर तारीख की कई सीमाओं का अनुरोध किया जाता है, तो जवाब वाली हर लाइन में तारीख की सीमा का इंडेक्स शून्य होगा. अगर तारीख की दो सीमाएं ओवरलैप होती हैं, तो ओवरलैप होने वाले दिनों के ऐक्सेस रिकॉर्ड, दोनों तारीख की सीमाओं के लिए जवाब वाली लाइनों में शामिल किए जाएंगे. अनुरोध की अनुमति, तारीख की दो सीमाओं तक की हो सकती है.
`dimensionFilter`	`object (AccessFilterExpression)` डाइमेंशन फ़िल्टर की मदद से, रिपोर्ट के लिए उन डाइमेंशन वैल्यू को सीमित किया जा सकता है जो फ़िल्टर से मैच करती हैं. उदाहरण के लिए, किसी एक उपयोगकर्ता के ऐक्सेस रिकॉर्ड को फ़िल्टर करना. ज़्यादा जानकारी के लिए, डाइमेंशन फ़िल्टर की बुनियादी बातें देखें. इस फ़िल्टर में, मेट्रिक इस्तेमाल नहीं की जा सकतीं.
`metricFilter`	`object (AccessFilterExpression)` मेट्रिक फ़िल्टर की मदद से, रिपोर्ट के रिस्पॉन्स को फ़िल्टर से मेल खाने वाली मेट्रिक की खास वैल्यू के लिए सीमित किया जा सकता है. मेट्रिक फ़िल्टर, रिपोर्ट की पंक्तियों को इकट्ठा करने के बाद लागू किए जाते हैं. यह ठीक उसी तरह काम करता है जैसे SQL वाले-क्लॉज़ से होता है. इस फ़िल्टर में डाइमेंशन इस्तेमाल नहीं किए जा सकते.
`offset`	`string (int64 format)` शुरुआती लाइन के लिए पंक्तियों की संख्या. पहली लाइन की गिनती, लाइन 0 के तौर पर की जाती है. अगर ऑफ़सेट की जानकारी नहीं दी जाती है, तो इसे 0 माना जाता है. अगर ऑफ़सेट शून्य है, तो यह तरीका `limit` एंट्री के साथ नतीजों का पहला पेज दिखाएगा. इस पेज नंबर के पैरामीटर के बारे में ज़्यादा जानने के लिए, पेज पर नंबर डालना लेख पढ़ें.
`limit`	`string (int64 format)` कितनी पंक्तियां लौटानी हैं, इसे बताने वाली संख्या. तय न होने पर, 10,000 लाइनें दिखाई जाती हैं. एपीआई हर अनुरोध में ज़्यादा से ज़्यादा 1,00, 000 लाइनें दिखाता है. इससे कोई फ़र्क़ नहीं पड़ता कि आपने कितनी पंक्तियां मांगी हैं. `limit` पॉज़िटिव होना चाहिए. अगर `limit` की तरह ज़्यादा पंक्तियां नहीं बची हैं, तो एपीआई, अनुरोध की गई `limit` से कम पंक्तियां दिखा सकता है. उदाहरण के लिए, `country` डाइमेंशन के लिए 300 से कम वैल्यू हो सकती हैं. इसलिए, सिर्फ़ `country` पर रिपोर्ट करते समय, 300 से ज़्यादा पंक्तियां नहीं हो सकतीं, भले ही `limit` को ज़्यादा वैल्यू पर सेट किया गया हो. इस पेज नंबर के पैरामीटर के बारे में ज़्यादा जानने के लिए, पेज पर नंबर डालना लेख पढ़ें.
`timeZone`	`string` इस अनुरोध का टाइम ज़ोन, अगर तय किया गया हो. अगर इसकी जानकारी नहीं दी गई है, तो प्रॉपर्टी के टाइम ज़ोन का इस्तेमाल किया जाता है. अनुरोध के टाइम ज़ोन का इस्तेमाल, रिपोर्ट के शुरू और खत्म होने की तारीख को समझने के लिए किया जाता है. जिसे IANA टाइम ज़ोन डेटाबेस (https://www.iana.org/time-zones) से स्ट्रिंग के तौर पर फ़ॉर्मैट किया गया हो. उदाहरण के लिए, "America/New_York" या "Asia/Tokyo".
`orderBys[]`	`object (AccessOrderBy)` इससे पता चलता है कि जवाब में पंक्तियों को किस क्रम में लगाया जाता है.
`returnEntityQuota`	`boolean` इस Analytics प्रॉपर्टी के कोटा की मौजूदा स्थिति दिखाने या न दिखाने के लिए टॉगल करता है. कोटे को ऐक्सेस कोटे में भेजा जाता है. खाता-लेवल के अनुरोधों के लिए, यह फ़ील्ड गलत होना चाहिए.
`includeAllUsers`	`boolean` ज़रूरी नहीं. यह तय करता है कि उन उपयोगकर्ताओं को शामिल किया जाए या नहीं जिन्होंने रिस्पॉन्स में कभी एपीआई कॉल नहीं किया है. सही होने पर, बताई गई प्रॉपर्टी या खाते का ऐक्सेस रखने वाले सभी उपयोगकर्ताओं को जवाब में शामिल किया जाता है. भले ही, उन्होंने कोई एपीआई कॉल किया हो या नहीं. गलत होने पर, सिर्फ़ उन उपयोगकर्ताओं को शामिल किया जाएगा जिन्होंने एपीआई कॉल किया है.
`expandGroups`	`boolean` ज़रूरी नहीं. यह तय करता है कि उपयोगकर्ता ग्रुप में मौजूद उपयोगकर्ताओं को वापस करना है या नहीं. यह फ़ील्ड सिर्फ़ तब काम करता है, जब includeAllUsers को 'सही है' पर सेट किया गया हो. वैल्यू सही होने पर, यह उन सभी उपयोगकर्ताओं को दिखाएगा जिनके पास बताई गई प्रॉपर्टी या खाते का ऐक्सेस होता है. गलत होने पर, सिर्फ़ सीधे ऐक्सेस वाले उपयोगकर्ताओं को ही दिखाया जाएगा.

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

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

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

नीचे दिए गए OAuth दायरों में से किसी एक की ज़रूरत होती है:

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