इस दस्तावेज़ में Google Analytics Reporting API v4 के लिए, संसाधन आधारित कोटा सिस्टम के बारे में जानकारी दी गई है. यह सिस्टम सिर्फ़ Analytics 360 के ग्राहकों के लिए उपलब्ध है. एपीआई पर लागू की गई सीमाओं के पूरे सेट के बारे में जानने के लिए, एपीआई की सीमाएं और कोटा देखें.
शुरुआती जानकारी
शेयर किए गए संसाधनों की उपलब्धता और विश्वसनीयता बनाए रखने के लिए, Analytics Reporting API को ऐक्सेस करने वाले हर प्रोजेक्ट पर सीमाएं और कोटे लागू होते हैं. बड़े डेटासेट की क्वेरी करते समय, सैंपलिंग का इस्तेमाल Analytics Reporting API की मदद से किया जा सकता है. इससे आपके डेटा के नतीजों पर असर पड़ सकता है.
संसाधन आधारित कोटा सिस्टम एक नया कोटा सिस्टम है. इससे Analytics Reporting API का इस्तेमाल करते समय, Analytics 360 खातों में सैंपलिंग के ज़्यादा थ्रेशोल्ड मिलेंगे. यह सिस्टम ज़रूरी नहीं है और व्यू और प्रोजेक्ट के लिए तय की गई मौजूदा सीमाओं से अलग है. जैसे, Google API कंसोल के कोटा पेज में रिपोर्ट किए जाने वाले डेटा.
संसाधन आधारित कोटा
सभी अनुरोध एक जैसे नहीं बनाए जाते. कुछ अनुरोध, दूसरों की तुलना में हिसाब से ज़्यादा महंगे होते हैं. संसाधन पर आधारित कोटा सिस्टम को इस तरह से डिज़ाइन किया गया है कि Analytics रिपोर्टिंग इंफ़्रास्ट्रक्चर की सुरक्षा करते हुए, सैंपलिंग की ज़्यादा से ज़्यादा संख्या का इस्तेमाल किया जा सके.
हर प्रॉपर्टी को क्वेरी संसाधन टोकन की एक तय संख्या दी जाएगी. एपीआई क्लाइंट, एपीआई अनुरोध में एक वैकल्पिक फ़ील्ड जोड़ सकता है, ताकि रिलेटिव क्वेरी रिसॉर्स टोकन के बदले, सैंपलिंग की ज़्यादा सीमा मिल सके. कंप्यूटर के हिसाब से ज़्यादा महंगे अनुरोध के लिए ज़्यादा टोकन की ज़रूरत होती है.
सैंपलिंग थ्रेशोल्ड
Google Analytics API v4 का इस्तेमाल करके डेटा के अनुरोध, अनुरोध की गई तारीख की सीमा (प्रॉपर्टी लेवल पर) के सेशन की संख्या के आधार पर सैंपलिंग के नीचे दिए गए सामान्य थ्रेशोल्ड के मुताबिक होते हैं:
- Analytics स्टैंडर्ड: पांच लाख सेशन
- Analytics 360: 10 लाख सेशन
- संसाधन पर आधारित कोटा का इस्तेमाल करने वाला Analytics 360: 10 करोड़ सेशन
संसाधन आधारित कोटा चालू करें
किसी अनुरोध के लिए संसाधन आधारित कोटा चालू करने के लिए, एपीआई कॉल में batchGet तरीके में useResourceQuotas फ़ील्ड शामिल होना चाहिए. हालांकि, यह ज़रूरी नहीं है.
{
"reportRequests": [{object(ReportRequest)}],
"useResourceQuotas": boolean,
}
उदाहरण के लिए:
{
"reportRequests":[
{
"viewId":"XXXX",
"dateRanges":[
{
"startDate":"2017-06-15",
"endDate":"2017-06-30"
}],
"metrics":[
{
"expression":"ga:sessions"
}],
"dimensions": [
{
"name":"ga:browser"
}]
}],
"useResourceQuotas": true
}
क्वेरी संसाधन की लागत का रिस्पॉन्स फ़ील्ड
batchGet वाले तरीके को किए गए हर कॉल के लिए, रिस्पॉन्स में queryCost फ़ील्ड होगा.
{
"reports": [{ object(Report) }],
"queryCost": number
}
queryCost फ़ील्ड, batchGet अनुरोध में शामिल सभी ReportRequests की कुल संसाधन लागत को दिखाने वाला पूर्णांक है.
उदाहरण के लिए:
{
"reports": [
{
"columnHeader": {...},
"data": {
"rows": [...]
}
}
],
"queryCost": 1337
}
कोटा आवंटन
Analytics 360 प्रॉपर्टी कोटा
- हर प्रॉपर्टी के लिए हर दिन 1,00,000 क्वेरी की लागत यूनिट.
- हर प्रॉपर्टी के लिए हर घंटे 25,000 क्वेरी की लागत यूनिट.
अगर कोटे की तय सीमा पार हो जाती है, तो आपको RESOURCE_EXHAUSTED गड़बड़ी मिलेगी. ज़्यादा जानकारी के लिए गड़बड़ी के जवाब देखें.
कीमत का हिसाब
अनुरोध की लागत इनके अनुपात में होती है:
- तारीख की सीमा का साइज़.
- व्यू में हिट की संख्या.
- अनुरोध किए गए डाइमेंशन के एलिमेंट की संख्या.
- अनुरोध किए गए डाइमेंशन और मेट्रिक की संख्या.
- सेगमेंट और फ़िल्टर की परिभाषाओं की जटिलता.
- मांगी गई जानकारी के प्रोसेस होने की स्थिति (आज के डेटा के लिए अनुरोध करना, बीते हुए कल के डेटा के लिए अनुरोध करने से ज़्यादा महंगा है).
- क्वेरी टाइम इंपोर्ट डाइमेंशन और मेट्रिक की मौजूदगी.
एपीआई की सीमाएं और इस्तेमाल
संसाधन आधारित कोटा सिस्टम के अलावा, एपीआई पर Analytics API v4 की सीमाएं और कोटा भी लागू होते हैं.
ज़रूरी जानकारी
queryCostरिस्पॉन्स फ़ील्ड, किसी अनुरोध की कंप्यूटेशनल कॉस्ट दिखाता है. इस एपीआई का इस्तेमाल करने के लिए, कोई शुल्क नहीं लगता और इसे बिना किसी शुल्क के इस्तेमाल किया जा सकता है.- इंट्रा-डे और कुछ पुराने डेटा (1 साल से ज़्यादा पुराने) की रिपोर्ट पर अब भी सैंपलिंग लागू की जा सकती है, भले ही
useResourceQuotasसेटिंग कुछ भी हो. - अगर किसी अनुरोध के लिए, सैंपलिंग का ज़्यादा थ्रेशोल्ड पूरा नहीं किया जा सकता है, तो संसाधन कोटा टोकन से कटौती नहीं की जाएगी. सैंपल किए गए जवाबों में, संसाधन कोटा की लागत हमेशा शून्य होती है.
- अगर रिस्पॉन्स में
samplesReadCounts,samplingSpaceSizesफ़ील्ड मौजूद हैं, तो रिपोर्ट में सैंपल डेटा शामिल होता है.
अपने प्रोजेक्ट के इस्तेमाल की सीमाएं देखने या बदलने या कोटा बढ़ाने का अनुरोध करने के लिए, यह तरीका अपनाएं:
- अगर आपके पास अपने प्रोजेक्ट के लिए, पहले से कोई बिलिंग खाता नहीं है, तो एक खाता बनाएं.
- एपीआई कंसोल में, एपीआई लाइब्रेरी के चालू एपीआई पेज पर जाएं और सूची से कोई एपीआई चुनें.
- कोटा से जुड़ी सेटिंग देखने और उनमें बदलाव करने के लिए, कोटा चुनें. इस्तेमाल के आंकड़े देखने के लिए, इस्तेमाल को चुनें.