কোটার সীমা

ন্যায্য ব্যবহার নিশ্চিত করতে এবং সিস্টেমের স্থিতিশীলতা রক্ষা করার জন্য, গুগল বিজনেস প্রোফাইল (GBP) API-গুলো API অনুরোধের উপর কোটা আরোপ করে। যদি আপনার অনুরোধ কোটার সীমা অতিক্রম করে, তাহলে API-টি একটি 429 Too Many Requests HTTP স্ট্যাটাস কোড (অথবা gRPC-এর জন্য RESOURCE_EXHAUSTED ) দিয়ে সাড়া দেয়।

ডিফল্ট কোটা সীমা

নিম্নলিখিত সারণিতে গুগল বিজনেস প্রোফাইল এপিআই-এর জন্য নির্ধারিত কোটা সীমা তালিকাভুক্ত করা হয়েছে। এই সীমা দুটি মাত্রার উপর ভিত্তি করে সংজ্ঞায়িত করা হয়েছে:

• প্রতি মিনিটে কোয়েরি (QPM): স্বল্পমেয়াদী আকস্মিক ট্র্যাফিক সীমিত করার মাধ্যমে ব্যাকএন্ডের স্থিতিশীলতা রক্ষা করে।
• দৈনিক কোয়েরি (QPD): প্ল্যাটফর্মের সামগ্রিক দৈনিক ব্যবহার পরিচালনা করে।

কোটা ত্রুটি এড়ানোর সর্বোত্তম উপায়

সারাদিন ধরে আপনার অনুরোধগুলো অবিচ্ছিন্নভাবে এবং সমানভাবে ছড়িয়ে দিলে অধিকাংশ কোটা ত্রুটি প্রতিরোধ করা যায়। আপনার অ্যাপ্লিকেশনটি যেন নির্ভরযোগ্যভাবে ডেটা সিঙ্ক্রোনাইজ করে, তা নিশ্চিত করতে এই সর্বোত্তম অনুশীলনগুলো অনুসরণ করুন।

আপনার অনুরোধগুলো সমানভাবে ভাগ করুন।

একসাথে অনেকগুলো অনুরোধ পাঠানোর পরিবর্তে, আপনার অনুরোধগুলোকে একটি দীর্ঘ সময় ধরে ভাগ করে পাঠান। উদাহরণস্বরূপ, 300 QPM-এর একটি সীমা মানে প্রতি সেকেন্ডে গড়ে ৫টি অনুরোধ। অনুরোধগুলোর মধ্যে একটি সংক্ষিপ্ত বিলম্ব রাখলে হঠাৎ ট্র্যাফিকের আকস্মিক বৃদ্ধি রোধ করা যায়।

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

ডেটা অ্যাক্সেস অপ্টিমাইজ করুন

• স্থির ডেটা ক্যাশ করুন: কদাচিৎ পরিবর্তনশীল ডেটা বারবার এপিআই কোয়েরি করার পরিবর্তে স্থানীয়ভাবে সংরক্ষণ করুন।
• পাব/সাব নোটিফিকেশন ব্যবহার করুন: এপিআই পোলিং ছাড়াই আপনার ডাটাবেসগুলোকে রিয়েল টাইমে আপডেট রাখতে পাব/সাব নোটিফিকেশনে সাবস্ক্রাইব করুন।
• বেশি ডেটা পড়ার প্রয়োজন হয় এমন এন্ডপয়েন্টগুলো ক্রমানুসারে প্রসেস করুন: SearchListings মতো বেশি ডেটা পড়ার প্রয়োজন হয় এমন এন্ডপয়েন্টগুলোতে একই সাথে একাধিক রিকোয়েস্ট চালানো থেকে বিরত থাকুন। এর পরিবর্তে, পেজিনেশন টোকেন ব্যবহার করে কাজগুলো ক্রমানুসারে প্রসেস করুন।

কোটা বৃদ্ধির জন্য অনুরোধ করুন

কোটা বৃদ্ধির অনুরোধ করার আগে, আপনার অনুরোধের পরিমাণ অপ্রয়োজনীয়ভাবে কেন্দ্রীভূত হচ্ছে না তা নিশ্চিত করতে গুগল ক্লাউড কনসোলে আপনার ব্যবহারের ধরণ যাচাই করুন।

আপনি আপনার বর্তমান সীমা দক্ষতার সাথে ব্যবহার করছেন কিনা, তা নিশ্চিত করতে গুগল বিজনেস প্রোফাইল টিম আপনার গড় কোটা ব্যবহারের উপর নজর রাখে। কোটা বৃদ্ধির অনুরোধ সাধারণত প্রত্যাখ্যান করা হয় যদি:

• আপনার অ্যাপ্লিকেশনটি ধারাবাহিকভাবে বর্তমান QPM সীমায় পৌঁছাতে পারে না।
• আপনার গড় ব্যবহার আপনার বর্তমান QPM সীমার ৫০% এর চেয়ে কম।
• আপনার অ্যাপ্লিকেশনটিতে অনুরোধের বিন্যাস মসৃণ না হয়ে বরং অত্যন্ত আকস্মিক ও অনিয়মিত।

একটি অনুরোধ জমা দিন

আপনি যদি এই সর্বোত্তম পদ্ধতিগুলো অনুসরণ করে থাকেন এবং তারপরেও আরও কোটার প্রয়োজন হয়, তাহলে একটি কোটা বৃদ্ধির অনুরোধ জমা দিন।

1. ড্রপ-ডাউন মেনু থেকে কোটা বৃদ্ধির অনুরোধ নির্বাচন করুন।
2. আপনার কোম্পানির নাম , যোগাযোগের ইমেল এবং প্রজেক্ট নম্বর প্রদান করুন।

আপনি ফর্মটি জমা দেওয়ার পর, গুগল বিজনেস প্রোফাইল টিম আপনার অনুরোধটি পর্যালোচনা করবে এবং কোটা বৃদ্ধি করা উপযুক্ত কিনা তা নির্ধারণ করবে। অনুরোধটি অনুমোদিত হলে, কোটা বাড়ানো হবে। অনুরোধটি প্রত্যাখ্যাত হলে, আপনাকে প্রত্যাখ্যানের কারণ জানানো হবে।