- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- ResponseMetaData
- SchemaRestrictionResponse
- ActiveMetricRestriction
- RestrictedMetricType
- इसे आज़माएं!
किसी रिपोर्ट टास्क का कॉन्टेंट वापस लाता है. reportTasks.create
का अनुरोध करने के बाद, रिपोर्ट के चालू होने के बाद, आपको रिपोर्ट का कॉन्टेंट वापस मिल जाएगा. अगर रिपोर्ट टास्क की स्थिति ACTIVE
नहीं है, तो इस तरीके से गड़बड़ी दिखेगी. क्वेरी के जवाब में रिपोर्ट की टेबल के तौर पर पंक्ति और कॉलम की वैल्यू दिखेगी.
एचटीटीपी अनुरोध
POST https://analyticsdata.googleapis.com/v1alpha/{name=properties/*/reportTasks/*}:query
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
name |
ज़रूरी है. रिपोर्ट के सोर्स का नाम. फ़ॉर्मैट: |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{ "offset": string, "limit": string } |
फ़ील्ड | |
---|---|
offset |
ज़रूरी नहीं. रिपोर्ट में शुरुआती पंक्ति की पंक्तियों की संख्या. पहली लाइन की गिनती पंक्ति 0 के तौर पर की जाती है. पेजिंग करते समय, पहला अनुरोध ऑफ़सेट तय नहीं करता है; या इसके बराबर, ऑफ़सेट को 0 पर सेट करता है; पहला अनुरोध पंक्तियों का पहली पेज पर नंबर डालने वाले इस पैरामीटर के बारे में ज़्यादा जानने के लिए, पेज पर नंबर डालना देखें. |
limit |
ज़रूरी नहीं. रिपोर्ट से दिखाई जाने वाली पंक्तियों की संख्या. इन्हें तय न करने पर, 10,000 लाइनें दिखती हैं. एपीआई हर अनुरोध में ज़्यादा से ज़्यादा 2,50,000 लाइनें दिखाता है, चाहे आपने कितनी भी लाइनें मांगी हों. अगर पेज पर नंबर डालने वाले इस पैरामीटर के बारे में ज़्यादा जानने के लिए, पेज पर नंबर डालना देखें. |
जवाब का मुख्य भाग
किसी रिपोर्ट टास्क से जुड़े कॉन्टेंट की रिपोर्ट.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{ "dimensionHeaders": [ { object ( |
फ़ील्ड | |
---|---|
dimensionHeaders[] |
डाइमेंशन कॉलम की जानकारी देता है. डाइमेंशनHeaders की संख्या और आयामHeaders का क्रम, पंक्तियों में मौजूद डाइमेंशन से मेल खाता है. |
metricHeaders[] |
मेट्रिक कॉलम के बारे में जानकारी देता है. MetricHeaders की संख्या और MetricHeaders का क्रम, पंक्तियों में मौजूद मेट्रिक से मेल खाता है. |
rows[] |
रिपोर्ट में डाइमेंशन वैल्यू के कॉम्बिनेशन और मेट्रिक वैल्यू की लाइनें. |
totals[] |
अनुरोध किए जाने पर, मेट्रिक की कुल वैल्यू. |
maximums[] |
अगर अनुरोध किया जाता है, तो मेट्रिक की ज़्यादा से ज़्यादा वैल्यू. |
minimums[] |
अनुरोध किए जाने पर, मेट्रिक की कम से कम वैल्यू. |
rowCount |
क्वेरी के नतीजे में लाइनों की कुल संख्या. |
metadata |
रिपोर्ट का मेटाडेटा. |
अनुमति के दायरे
इनमें से किसी एक OAuth दायरों की ज़रूरत होती है:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
ResponseMetaData
जवाब के मेटाडेटा में, शिकायत के कॉन्टेंट के बारे में ज़्यादा जानकारी शामिल है.
जेएसओएन के काेड में दिखाना |
---|
{
"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
इस रिपोर्ट को बनाने में स्कीमा प्रतिबंध सक्रिय रूप से लागू किए गए हैं. ज़्यादा जानने के लिए, ऐक्सेस और डेटा के इस्तेमाल से जुड़ी पाबंदियों को मैनेज करना देखें.
जेएसओएन के काेड में दिखाना |
---|
{
"activeMetricRestrictions": [
{
object ( |
फ़ील्ड | |
---|---|
activeMetricRestrictions[] |
रिपोर्ट बनाने के दौरान लागू की गई सभी पाबंदियां. उदाहरण के लिए, |
ActiveMetricRestriction
रिपोर्ट बनाने के लिए सक्रिय रूप से प्रतिबंधित मेट्रिक.
जेएसओएन के काेड में दिखाना |
---|
{
"restrictedMetricTypes": [
enum ( |
फ़ील्ड | |
---|---|
restrictedMetricTypes[] |
इस मेट्रिक पर पाबंदी लगाए जाने की वजह. |
metricName |
पाबंदी वाली मेट्रिक का नाम. |
RestrictedMetricType
डेटा की ऐसी कैटगरी जिन्हें कुछ GA4 प्रॉपर्टी पर देखने से रोका जा सकता है.
Enums | |
---|---|
RESTRICTED_METRIC_TYPE_UNSPECIFIED |
टाइप की जानकारी नहीं है. |
COST_DATA |
लागत मेट्रिक, जैसे कि adCost . |
REVENUE_DATA |
रेवेन्यू की मेट्रिक, जैसे कि purchaseRevenue . |