संसाधन आधारित कोटा

यह दस्तावेज़, Google Analytics रिपोर्टिंग एपीआई v4 के लिए संसाधन आधारित कोटा सिस्टम के बारे में बताता है जो सिर्फ़ Analytics 360 ग्राहकों के लिए उपलब्ध है. एपीआई पर लागू की गई सीमाओं के पूरे सेट के लिए, एपीआई की सीमाएं और कोटा देखें.

इसके बारे में जानकारी

यह पक्का करने के लिए कि शेयर किए गए संसाधनों की उपलब्धता और उनका भरोसेमंद होना, Analytics रिपोर्टिंग एपीआई को ऐक्सेस करने वाले हर प्रोजेक्ट पर सीमाएं और कोटा लागू होता हो. बड़े डेटासेट की क्वेरी करते समय, सैंपलिंग का इस्तेमाल, Analytics रिपोर्टिंग एपीआई कर सकता है. इससे आपके डेटा के नतीजों पर असर पड़ सकता है.

संसाधन आधारित कोटा सिस्टम एक नया कोटा सिस्टम है. यह Analytics रिपोर्टिंग एपीआई का इस्तेमाल करते समय, Analytics 360 खातों के लिए नमूने का विश्लेषण करने की ज़्यादा सीमा तय करेगा. यह सिस्टम वैकल्पिक है और व्यू और प्रोजेक्ट पर लगाई गई मौजूदा सीमाओं से अलग है, जैसे कि Google API (एपीआई) कंसोल के कोटा पेज पर रिपोर्ट की गई सीमाएं.

संसाधन आधारित कोटा

सभी अनुरोध एक जैसे नहीं होते; कुछ अनुरोध दूसरों की तुलना में ज़्यादा महंगा होते हैं. संसाधन आधारित कोटा सिस्टम को इस तरह डिज़ाइन किया गया है कि यह Analytics रिपोर्टिंग इंफ़्रास्ट्रक्चर की सुरक्षा करते हुए भी नमूने के ऊंचे थ्रेशोल्ड को बढ़ावा दे सके.

हर प्रॉपर्टी को क्वेरी रिसॉर्स टोकन की एक तय संख्या तय की जाएगी. एपीआई क्लाइंट, एपीआई अनुरोध में एक वैकल्पिक फ़ील्ड जोड़ सकता है. ऐसा करने से, मिलते-जुलते क्वेरी रिसॉर्स टोकन के बदले, सैंपलिंग की ज़्यादा संख्या मिल सकती है. कंप्यूटेशनल तरीके से ज़्यादा महंगे अनुरोध के लिए ज़्यादा टोकन की ज़रूरत होगी.

नमूने के विश्लेषण का थ्रेशोल्ड

Google Analytics API v4 का इस्तेमाल करने वाले डेटा के अनुरोध, अनुरोध की गई तारीख की सीमा के लिए सेशन की संख्या के आधार पर, नीचे दिए गए सामान्य सैंपलिंग थ्रेशोल्ड के तहत आते हैं (प्रॉपर्टी लेवल पर):

  • Analytics Standard: 5 लाख सेशन
  • 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 रिस्पॉन्स फ़ील्ड, किसी अनुरोध की कंप्यूटेशनल लागत दिखाता है. यह मॉनेटरी लागत नहीं है और एपीआई मुफ़्त में इस्तेमाल किया जा सकता है.
  • useResourceQuotas की सेटिंग के बावजूद, इंट्रा-डे और कुछ पुराने डेटा (1+ साल पुराना) रिपोर्ट के नमूने का विश्लेषण किया जा सकता है.
  • अगर किसी अनुरोध के लिए ऊंची सैंपलिंग सीमा पूरी नहीं हो पाती है, तो संसाधन कोटा टोकन नहीं काटा जाएगा (सैंपल के तौर पर दिए गए जवाबों के लिए हमेशा संसाधन कोटा की कीमत शून्य होगी).
  • अगर किसी रिपोर्ट में samplesReadCounts, samplingSpaceSizes मौजूद हैं, तो किसी रिपोर्ट में सैंपल किया गया डेटा होता है.

अपने प्रोजेक्ट के इस्तेमाल की सीमाओं को देखने या उनमें बदलाव करने या कोटा बढ़ाने का अनुरोध करने के लिए, ये काम करें:

  1. अगर आपके पास अपने प्रोजेक्ट के लिए पहले से कोई बिलिंग खाता नहीं है, तो खाता बनाएं.
  2. एपीआई कंसोल में, एपीआई लाइब्रेरी के चालू किए गए एपीआई पेज पर जाएं और सूची से कोई एपीआई चुनें.
  3. कोटा से जुड़ी सेटिंग देखने और बदलने के लिए, कोटा चुनें. इस्तेमाल के आंकड़े देखने के लिए, इस्तेमाल चुनें.