- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- ResponseMetaData
- SchemaRestrictionResponse
- ActiveMetricRestriction
- RestrictedMetricType
- इसे आज़माएं!
रिपोर्ट में मौजूद किसी टास्क का कॉन्टेंट हासिल करता है. reportTasks.create
का अनुरोध करने के बाद, रिपोर्ट के ऐक्टिव होने के बाद ही उससे जुड़ा कॉन्टेंट वापस लाया जा सकता है. अगर रिपोर्ट टास्क की स्थिति ACTIVE
नहीं है, तो यह तरीका गड़बड़ी दिखाएगा. क्वेरी के जवाब के आधार पर टेबल में और कॉलम वैल्यू.
एचटीटीपी अनुरोध
POST https://analyticsdata.googleapis.com/v1alpha/{name=properties/*/reportTasks/*}:query
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
name |
ज़रूरी है. रिपोर्ट के सोर्स का नाम. फ़ॉर्मैट: |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:
JSON के काेड में दिखाना |
---|
{ "offset": string, "limit": string } |
फ़ील्ड | |
---|---|
offset |
ज़रूरी नहीं. रिपोर्ट में शुरुआती लाइन की लाइनों की संख्या. पहली लाइन को शून्य के तौर पर गिना जाता है. पेजिंग करते समय, पहला अनुरोध ऑफ़सेट की जानकारी नहीं देता है; या इसके बराबर, ऑफ़सेट को 0 पर सेट करता है; पहला अनुरोध, पहली पेज पर नंबर डालने के इस पैरामीटर के बारे में ज़्यादा जानने के लिए, पेज पर नंबर डालना लेख पढ़ें. |
limit |
ज़रूरी नहीं. रिपोर्ट से दिखाई जाने वाली पंक्तियों की संख्या. अगर जानकारी नहीं दी गई है, तो 10,000 पंक्तियां दिखती हैं. एपीआई हर अनुरोध के लिए ज़्यादा से ज़्यादा 2,50, 000 लाइनें दिखाता है. इससे कोई फ़र्क़ नहीं पड़ता कि आपको कितनी लाइनें चाहिए. अगर डाइमेंशन वैल्यू पेज पर नंबर डालने के इस पैरामीटर के बारे में ज़्यादा जानने के लिए, पेज पर नंबर डालना लेख पढ़ें. |
जवाब का मुख्य भाग
रिपोर्ट में मौजूद किसी टास्क से जुड़ा रिपोर्ट कॉन्टेंट.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{ "dimensionHeaders": [ { object ( |
फ़ील्ड | |
---|---|
dimensionHeaders[] |
इससे डाइमेंशन कॉलम के बारे में जानकारी मिलती है. डाइमेंशन हेडर की संख्या और डाइमेंशन हेडर, पंक्तियों में मौजूद डाइमेंशन से मैच करते हैं. |
metricHeaders[] |
मेट्रिक कॉलम की जानकारी देता है. MetricHeaders की संख्या और MetricHeaders का क्रम, पंक्तियों में मौजूद मेट्रिक से मेल खाते हैं. |
rows[] |
रिपोर्ट में, डाइमेंशन वैल्यू के कॉम्बिनेशन और मेट्रिक की वैल्यू की लाइनें. |
totals[] |
अनुरोध किए जाने पर, मेट्रिक की कुल वैल्यू. |
maximums[] |
अनुरोध किए जाने पर, मेट्रिक की ज़्यादा से ज़्यादा वैल्यू. |
minimums[] |
अनुरोध किए जाने पर, मेट्रिक की कम से कम वैल्यू. |
rowCount |
क्वेरी के नतीजे में पंक्तियों की कुल संख्या. |
metadata |
रिपोर्ट का मेटाडेटा. |
अनुमति के दायरे
इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
ResponseMetaData
जवाब के मेटाडेटा में, रिपोर्ट के कॉन्टेंट के बारे में अतिरिक्त जानकारी होती है.
JSON के काेड में दिखाना |
---|
{
"dataLossFromOtherRow": boolean,
"schemaRestrictionResponse": {
object ( |
फ़ील्ड | |
---|---|
dataLossFromOtherRow |
अगर सही है, तो इससे पता चलता है कि डाइमेंशन कॉम्बिनेशन के कुछ बकेट "(अन्य)" में रोल किए गए हैं लाइन. ऐसा, ज़्यादा एलिमेंट की रिपोर्ट के मामले में हो सकता है. मेटाडेटा पैरामीटर dataLossFromOtherRow रिपोर्ट में इस्तेमाल की गई एग्रीगेट की गई डेटा टेबल के आधार पर भरा जाता है. रिपोर्ट में मौजूद फ़िल्टर और सीमाओं पर ध्यान दिए बिना, पैरामीटर में अपने-आप जानकारी भर जाएगी. उदाहरण के लिए, (अन्य) लाइन को रिपोर्ट से हटाया जा सकता है, क्योंकि अनुरोध में sessionSource = google का फ़िल्टर शामिल है. अगर इस रिपोर्ट को जनरेट करने के लिए इस्तेमाल किए गए कुल डेटा में, किसी अन्य लाइन का डेटा लीक हुआ है, तो इस पैरामीटर की जानकारी अपने-आप भर जाएगी. ज़्यादा जानने के लिए, (अन्य) लाइन और डेटा सैंपलिंग के बारे में जानकारी लेख पढ़ें. |
schemaRestrictionResponse |
इस रिपोर्ट को बनाने के लिए, लागू किए गए स्कीमा से जुड़ी पाबंदियों की जानकारी देता है. ज़्यादा जानने के लिए, ऐक्सेस और डेटा के इस्तेमाल से जुड़ी पाबंदियों को मैनेज करना लेख पढ़ें. |
currencyCode |
इस रिपोर्ट में इस्तेमाल किया गया मुद्रा कोड. इसे विज़ुअलाइज़ेशन के लिए, मुद्रा के कोड, ISO 4217 मानक (https://en.wikipedia.org/wiki/ISO_4217) में दी गई मुद्रा के प्रकारों की स्ट्रिंग एन्कोडिंग होती हैं; उदाहरण के लिए, "USD", "EUR", "JPY". ज़्यादा जानने के लिए, https://support.google.com/analytics/answer/9796179 पर जाएं. |
timeZone |
प्रॉपर्टी का मौजूदा टाइमज़ोन. इसे समय के हिसाब से बने डाइमेंशन, जैसे कि |
emptyReason |
अगर खाली वजह बताई गई है, तो उस वजह के लिए रिपोर्ट में कोई जानकारी नहीं होती. |
subjectToThresholding |
अगर |
SchemaRestrictionResponse
इस रिपोर्ट को बनाने के लिए, स्कीमा से जुड़ी पाबंदियां लागू की गई हैं. ज़्यादा जानने के लिए, ऐक्सेस और डेटा के इस्तेमाल से जुड़ी पाबंदियों को मैनेज करना लेख पढ़ें.
JSON के काेड में दिखाना |
---|
{
"activeMetricRestrictions": [
{
object ( |
फ़ील्ड | |
---|---|
activeMetricRestrictions[] |
रिपोर्ट बनाने में सभी पाबंदियां लागू की गई थीं. उदाहरण के लिए, |
ActiveMetricRestriction
ऐसी मेट्रिक जिसके इस्तेमाल से रिपोर्ट नहीं बनाई जा सकती.
JSON के काेड में दिखाना |
---|
{
"restrictedMetricTypes": [
enum ( |
फ़ील्ड | |
---|---|
restrictedMetricTypes[] |
इस मेट्रिक पर लगाई गई पाबंदी की वजह. |
metricName |
पाबंदी वाली मेट्रिक का नाम. |
RestrictedMetricType
डेटा की ऐसी कैटगरी जिन्हें कुछ GA4 प्रॉपर्टी पर देखने से आपको प्रतिबंधित किया जा सकता है.
Enums | |
---|---|
RESTRICTED_METRIC_TYPE_UNSPECIFIED |
टाइप की जानकारी नहीं है. |
COST_DATA |
लागत मेट्रिक, जैसे कि adCost . |
REVENUE_DATA |
रेवेन्यू की मेट्रिक, जैसे कि purchaseRevenue . |