सीमाएं

Google Business Profile (GBP) के एपीआई, एपीआई के अनुरोधों पर कोटा लागू करते हैं. इससे, सिस्टम की स्थिरता बनी रहती है और यह पक्का किया जाता है कि एपीआई का सही तरीके से इस्तेमाल हो. अगर आपका अनुरोध, कोटा की सीमा से ज़्यादा है, तो एपीआई, 429 Too Many Requests एचटीटीपी स्टेटस कोड (या gRPC के लिए RESOURCE_EXHAUSTED) के साथ जवाब देता है.

डिफ़ॉल्ट रूप से तय की गई कोटा की सीमाएं

यहां दी गई टेबल में, Google Business Profile के एपीआई के लिए तय की गई स्टैंडर्ड कोटा की सीमाएं दिखाई गई हैं. सीमाएं दो डाइमेंशन के हिसाब से तय की जाती हैं:

  • हर मिनट की क्वेरी (क्यूपीएम): इससे, कम समय में होने वाले ट्रैफ़िक में अचानक बढ़ोतरी को सीमित करके, बैकएंड की स्थिरता बनी रहती है.
  • हर दिन की क्वेरी (क्यूपीटी): इससे, प्लैटफ़ॉर्म के रोज़ाना के इस्तेमाल को मैनेज किया जाता है.
एपीआई सीमाएं
कारोबार की जानकारी देने वाला एपीआई
  • डिफ़ॉल्ट अनुरोध: 300 क्यूपीएम
  • जगह की जानकारी बनाने के अनुरोध: 300 क्यूपीटी
  • SearchGoogleLocation के अनुरोध: 300 क्यूपीटी
  • जगह की जानकारी अपडेट करने के अनुरोध: 10,000 क्यूपीटी
  • बदलाव: हर Google Business Profile के लिए, हर मिनट 10 बदलाव (इन्हें बढ़ाया नहीं जा सकता)
Account Management API 300 क्यूपीएम
Performance API 300 क्यूपीएम
जगह की पुष्टि का एपीआई 300 क्यूपीएम
लॉजिंग डेटा मैनेज करने का एपीआई 300 क्यूपीएम
Place Actions API 300 क्यूपीएम
नोटिफ़िकेशन एपीआई 300 क्यूपीएम

कोटा से जुड़ी गड़बड़ियों से बचने के सबसे सही तरीके

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

अपने अनुरोधों को एक जैसी संख्या में भेजें

एक ही समय पर, बड़ी संख्या में अनुरोध भेजने के बजाय, अपने अनुरोधों को a लंबे समय तक भेजें. उदाहरण के लिए, 300 क्यूपीएम की सीमा का मतलब है कि हर सेकंड औसतन पांच अनुरोध भेजे जा सकते हैं. अनुरोधों के बीच कुछ समय का अंतर रखने से, ट्रैफ़िक में अचानक बढ़ोतरी नहीं होती है. 

Traffic distribution patterns:

Spiky traffic (Discouraged): High burst of requests followed by an idle period
Requests |   |||                 |||
         |   |||                 |||
         +---------------------------------
           Time ──>

Even traffic (Recommended): Consistent rate of requests over time
Requests |  |  |  |  |  |  |  |  |  |
         |  |  |  |  |  |  |  |  |  |
         +---------------------------------
           Time ──>
 
import time

# Pace requests to stay within the 300 QPM limit (5 requests/sec)
for request in batch_requests:
    send_request(request)
    time.sleep(0.2)  # 200ms delay ensures a smooth distribution

एक्स्पोनेंशियल बैकऑफ़ के साथ जिटर लागू करना

जब आपको 429 Too Many Requests गड़बड़ी मिले, तो अनुरोध को अपने-आप फिर से भेजने के लिए, एक्स्पोनेंशियल बैकऑफ़ के साथ जिटर का इस्तेमाल करें. इस स्टैंडर्ड तरीके में, अनुरोध को फिर से भेजने से पहले, कुछ समय के लिए इंतज़ार किया जाता है. यह समय रैंडम होता है. इसके बाद, अनुरोध को फिर से भेजने में लगने वाले समय को धीरे-धीरे बढ़ाया जाता है. 

import random
import time
from googleapiclient.errors import HttpError

def call_api_with_retry(api_method, max_retries=5):
    base_delay = 1.0
    for attempt in range(max_retries):
        try:
            return api_method.execute()
        except HttpError as e:
            if e.resp.status == 429:
                if attempt == max_retries - 1:
                    raise e
                # Retry with exponential backoff and jitter
                sleep_time = random.uniform(0, base_delay * (2 ** attempt))
                time.sleep(sleep_time)
            else:
                raise e

डेटा के ऐक्सेस को ऑप्टिमाइज़ करना

  • स्टैटिक डेटा को कैश मेमोरी में सेव करना: बार-बार एपीआई से क्वेरी करने के बजाय, ऐसे डेटा को स्थानीय तौर पर सेव करें जिसमें बार-बार बदलाव नहीं होता.
  • Pub/Sub सूचनाओं का इस्तेमाल करना: एपीआई से पोलिंग किए बिना, अपने डेटाबेस को रीयल टाइम में अपडेट रखने के लिए, Pub/Sub सूचनाओं की सदस्यता लें.
  • रीड-हैवी एंडपॉइंट को क्रम से प्रोसेस करना: एक साथ कई अनुरोध भेजने से बचें जैसे रीड-हैवी एंडपॉइंट के लिए SearchListings. इसके बजाय, पेज पर नंबर दिखाने वाले टोकन का इस्तेमाल करके, टास्क को क्रम से प्रोसेस करें.

कोटा बढ़ाने का अनुरोध करना

कोटा बढ़ाने का अनुरोध करने से पहले, Google Cloud Console में अपने इस्तेमाल के पैटर्न की पुष्टि करें. इससे यह पक्का किया जा सकेगा कि आपके अनुरोधों की संख्या ज़रूरत से ज़्यादा नहीं है.

Google Business Profile की टीम, आपके औसत कोटा के इस्तेमाल पर नज़र रखती है. इससे यह पक्का किया जाता है कि आप मौजूदा सीमाओं का सही तरीके से इस्तेमाल कर रहे हैं . कोटा बढ़ाने के अनुरोध आम तौर पर तब अस्वीकार कर दिए जाते हैं, जब:

  • आपका ऐप्लिकेशन, मौजूदा क्यूपीएम सीमा तक लगातार नहीं पहुंचता.
  • आपका औसत इस्तेमाल, मौजूदा क्यूपीएम सीमा के 50% से कम है.
  • आपका ऐप्लिकेशन, अनुरोधों को आसानी से डिस्ट्रिब्यूट करने के बजाय, अचानक से बड़ी संख्या में अनुरोध भेजता है.

Submit a request

अगर आपने इन सबसे सही तरीकों को लागू किया है और आपको अब भी ज़्यादा कोटा की ज़रूरत है, तो कोटा बढ़ाने का अनुरोध सबमिट करें.

  1. ड्रॉप-डाउन मेन्यू में जाकर, कोटा बढ़ाने का अनुरोध चुनें.
  2. अपना कंपनी का नाम, संपर्क करने के लिए ईमेल पता, और प्रोजेक्ट नंबर डालें.

फ़ॉर्म सबमिट करने के बाद, Google Business Profile की टीम आपके अनुरोध की समीक्षा करेगी और यह तय करेगी कि कोटा बढ़ाना सही है या नहीं. अगर अनुरोध स्वीकार कर लिया जाता है, तो कोटा बढ़ा दिया जाएगा. अगर अनुरोध अस्वीकार कर दिया जाता है, तो आपको अस्वीकार करने की वजह बताई जाएगी.