কোটা

Merchant API-তে প্রযোজ্য কোটা এই ডকুমেন্টে তালিকাভুক্ত করা আছে।

Merchant API কোটা ব্যবহার করে যাতে সব ব্যবহারকারীর জন্য একটি স্থিতিশীল ও ন্যায্য পরিবেশ নিশ্চিত করা যায়। কোটা কোনও একজন API ব্যবহারকারীকে সিস্টেমের উপর অতিরিক্ত লোড রাখতে বাধা দেয়, যা খুব ভালো পারফর্ম্যান্স নিশ্চিত করে। এই কোটাগুলি বোঝা হল আপনার প্রোডাক্ট ডেটা ম্যানেজ করা এবং Google-এ আপনার ব্যবসা বাড়ানোর মূল চাবিকাঠি।

সাধারণ ধারণা

কোটা গ্রুপের মাধ্যমে মার্চেন্ট API কোটা ম্যানেজ করা হয়।

API পদ্ধতি কোটা গ্রুপের সাথে ম্যাপ করা হয়। এই ম্যাপিংয়ের স্ট্রাকচার আলাদা আলাদা হতে পারে:

• প্রতি গ্রুপে একটি পদ্ধতি: কিছু কোটা গ্রুপ একটি API পদ্ধতির ক্ষেত্রে প্রযোজ্য। যেমন, তালিকাভুক্ত ডেটা সোর্স পদ্ধতির accounts.dataSources.list নিজস্ব কোটা গ্রুপ আছে।
• প্রতিটি গ্রুপের জন্য একাধিক পদ্ধতি (বান্ডেল করা): প্রায়ই, সম্পর্কিত পদ্ধতিগুলিকে একটি কোটা গ্রুপে বান্ডেল করা হয়। ওই গ্রুপের মধ্যে থাকা সব পদ্ধতি একই দৈনিক ও প্রতি-মিনিট সীমা শেয়ার করে। সাধারণ উদাহরণের মধ্যে এগুলি পড়ে:
  • এই ধরনের পদ্ধতি ও রিসোর্সের জন্য সব রিড অপারেশনকে গ্রুপ করা, যেমন merchant-accounts-read-methods।
  • সম্পর্কিত পদ্ধতি ও রিসোর্সের জন্য সবকটি লেখার অপারেশনকে গ্রুপ করা, যেমন merchant-accounts-write-methods।

প্রতিটি মেথড কলকে একবার করে গণনা করা হয়, সেটির ধরন যাই হোক না কেন। ২৫০টি আইটেমের একটি list অনুরোধকে ২৫০টি get অনুরোধ হিসেবে নয়, শুধুমাত্র একটি অনুরোধ হিসেবেই গণনা করা হয়।

বিল্ট-ইন HTTP ব্যাচিং কোটার উপর প্রভাব ফেলে না। অনুরোধের ব্যাচের মধ্যে থাকা প্রতিটি অনুরোধ কোটার বিপক্ষে একটি হিসেবে গণনা করা হয়। যেমন, ৫০০টি insert অনুরোধ সহ একটি ব্যাচ অনুরোধকে ৫০০টি আলাদা insert পদ্ধতি অনুরোধ হিসেবে চার্জ করা হয়।

ডেডিকেটেড অঞ্চলের ব্যাচিংয়ের ব্যতিক্রম: বিশেষ অঞ্চলের ব্যাচ পদ্ধতি (batchCreate, batchUpdate, batchDelete) merchant_regions কোটা গ্রুপের বিরুদ্ধে একটি API কল হিসেবে গণনা করা হয়, পে-লোডে থাকা অঞ্চলের অপারেশনের সংখ্যা নির্বিশেষে।

আপনার ইন্টিগ্রেশন কার্যকরভাবে ম্যানেজ করতে, আপনি যে API পদ্ধতি ব্যবহার করতে চান সেটির সাথে যুক্ত নির্দিষ্ট কোটা গ্রুপ পর্যালোচনা করে দেখা উচিত। আপনি কোটার তালিকা পদ্ধতি থেকে এইসব বিবরণ পেতে পারেন। আরও তথ্যের জন্য, মনিটরিং ও ভিজিবিলিটি দেখুন।

আপডেট নীতি

আপডেট সংক্রান্ত নিম্নলিখিত নীতি Merchant API প্রয়োগ করে:

• সাধারণত, আপনি দিনে সর্বাধিক দু'বার আপনার প্রোডাক্ট আপডেট করতে পারবেন। প্রতি মিনিটে কোটা মেনে চলার জন্য আপনাকে সারাদিন ধরে সমানভাবে কল স্প্রেড করতে হবে।
• সাধারণত, আপনি দিনে সর্বাধিক দু'বার আপনার সাব-অ্যাকাউন্ট আপডেট করতে পারবেন। আপনার দৈনিক সাব-অ্যাকাউন্ট আপডেট কোটা হল আপনার মোট অনুমোদিত সাব-অ্যাকাউন্টের উপর ভিত্তি করে একটি সামগ্রিক সীমা।
• ডিফল্ট হিসেবে, আপনি শুধুমাত্র নিজের সাব-অ্যাকাউন্টের জন্য ডেটা সোর্স পদ্ধতি কল করতে পারবেন, যেমন list বা create, প্রতি সাব-অ্যাকাউন্টে দিনে সর্বাধিক দু'বার।

রেট কোটা

প্রতিটি কোটা গ্রুপে দুই ধরনের সীমা (এবং দৈনিক ব্যবহার) থাকে:

• দৈনিক সীমা (quotaLimit): প্রতি দিনে সর্বাধিক যতগুলি অনুরোধ করা যায়। UTC অনুযায়ী দুপুর ১২টায় দৈনিক কোটা রিসেট হয়ে যায়।
• প্রতি মিনিটের সীমা (quotaMinuteLimit): প্রতি মিনিটে অনুমোদিত অনুরোধের সর্বাধিক সংখ্যা, অনুরোধের হার নিয়ন্ত্রণ করে। প্রতি মিনিটের কোটা রোলিং উইন্ডো ব্যবহার করে, যেখানে এনফোর্সমেন্ট পিরিয়ড শুরু হয় সেই মুহূর্ত থেকে যখন সেই পদ্ধতি ও রিসোর্সের জন্য প্রথম API কল করা হয়। যেমন, আপনি যদি সকাল ১০:০১:৩০-এ কল করেন, তাহলে সেই পদ্ধতির জন্য প্রতি মিনিটের কোটা উইন্ডো সকাল ১০:০২:৩০ পর্যন্ত চলবে।
• দৈনিক ব্যবহার (quotaUsage): বর্তমান দিনের জন্য দৈনিক সীমার বিপক্ষে ইতিমধ্যেই করা এবং গণনা করা অনুরোধের সংখ্যা। ফিল্ডটি না থাকলে, এই গ্রুপের জন্য এখনও কোনও কোটা ব্যবহার করা হয়নি।

আপনি আগে বর্ণিত তিনটি ফিল্ড (quotaLimit, quotaMinuteLimit এবং quotaUsage) quotas.list মেথডের উত্তরে দেখতে পাবেন।

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

কোটা বরাদ্দকরণ ও হায়ারার্কি

এই বিভাগে Merchant API কার হয়ে কোটা ব্যবহার ট্র্যাক ও প্রয়োগ করে তা ব্যাখ্যা করা হয়েছে:

সাধারণত, যে ব্যবহারকারী API অনুরোধ করেন তার উপর ভিত্তি করে কোটা চার্জ করা হয়।

• স্ট্যান্ড-অ্যালোন অ্যাকাউন্ট: কোনও API কল যাচাই করার জন্য স্ট্যান্ড-অ্যালোন অ্যাকাউন্টের ক্ষেত্রে, সেই অনুরোধটি অ্যাকাউন্টের কোটার বিরুদ্ধে গণনা করা হয়।
  • যেমন: কোনও মার্চেন্ট জুতো স্টোর ক (অ্যাকাউন্ট আইডি: 12345) নিজের অ্যাকাউন্টকে টার্গেট করে products.insert কল করার জন্য নিজের পরিষেবা অ্যাকাউন্ট ব্যবহার করে প্রমাণীকরণ করে (accounts/12345)। জুতো স্টোর ক-এর কোটা পুল থেকে কোটা ব্যবহার করা হয়।
• উন্নত অ্যাকাউন্ট: উন্নত অ্যাকাউন্ট হিসেবে যাচাইকরণ করা হলে সাব-অ্যাকাউন্ট টার্গেট করা হলেও উন্নত অ্যাকাউন্টের পুল থেকে কোটা ব্যবহার করা হয়।
  • যেমন: একটি এজেন্সি রিটেল ম্যানেজমেন্ট অ্যাকাউন্ট (অ্যাডভান্সড অ্যাকাউন্ট আইডি: 12345) একটি সাব-অ্যাকাউন্ট Clothing Store B (অ্যাকাউন্ট আইডি: 11111) ম্যানেজ করে। এজেন্সি তার নিজস্ব ক্রেডেনশিয়াল ব্যবহার করে যাচাই করে এবং products.insert Clothing Store B (accounts/11111)-কে টার্গেট করে। কোটা সাব-অ্যাকাউন্টের পুল থেকে নয়, মূল এজেন্সির পুল থেকে (উন্নত অ্যাকাউন্ট আইডি: 12345) ব্যবহার করা হয়।
• সাব-অ্যাকাউন্ট: কোনও সাব-অ্যাকাউন্টের ক্রেডেনশিয়াল ব্যবহার করে API কল যাচাই করা হলে, সেই সাব-অ্যাকাউন্টের স্বতন্ত্র পুল থেকে কোটা চার্জ করা হয়। এটি একটি স্বতন্ত্র অ্যাকাউন্টের মতোই কাজ করে, যদিও এটি অভিভাবকের উন্নত অ্যাকাউন্ট দ্বারা ম্যানেজ করা হয়।
  • যেমন: আগের মতো একই সেট-আপ ব্যবহার করে, পোশাকের দোকান খ (অ্যাকাউন্ট আইডি: 11111) যদি products.insert কল করার জন্য তাদের সাব-অ্যাকাউন্টের জন্য বিশেষভাবে সেট-আপ করা ক্রেডেনশিয়াল ব্যবহার করে নিজের অ্যাকাউন্টকে (accounts/11111) টার্গেট করে, তাহলে কোটা পোশাকের দোকান খ-এর স্বতন্ত্র কোটা পুল থেকে ব্যবহার করা হবে, এর ফলে মূল এজেন্সির পুল অক্ষত থাকবে।

সাধারণ নিয়মের ব্যতিক্রম

কোটা বরাদ্দ সংক্রান্ত সাধারণ নিয়মের ক্ষেত্রে কিছু নির্দিষ্ট ব্যতিক্রম প্রযোজ্য হয়:

• Accounts.list: এই পদ্ধতির কোটা যাচাইকৃত ব্যবহারকারী বা কল করা পরিষেবা অ্যাকাউন্টের উপর চার্জ করা হয়, Merchant Center অ্যাকাউন্ট আইডির উপর নয়। এর কোটা ব্যবহার স্ট্যান্ডার্ড Merchant Center API ডায়াগনস্টিক পৃষ্ঠায় দেখা যাবে না। আপনার উন্নত অ্যাকাউন্ট থাকলে, আমরা accounts.listSubaccounts পদ্ধতি ব্যবহার করার সাজেশন দিই, যা আপনার উন্নত অ্যাকাউন্টের কোটার মধ্যে গণনা করা হয়।
• সমস্যার সমাধান করার পদ্ধতি: এই পদ্ধতিগুলি সবসময় সেই অ্যাকাউন্টের কোটার বিরুদ্ধে গণনা করা হয়, যেটির সমস্যা সমাধান করার অনুরোধ করা হচ্ছে, এমনকি অন্য কোনও অ্যাকাউন্ট অনুরোধটি যাচাই করলেও।

অ্যালোকেশন হায়ারার্কি

• কেনাকাটার তুলনামূলক পরিষেবা (CSS): CSS হল এমন ওয়েবসাইট যা প্রোডাক্ট অফার একত্রিত করে এবং ব্যবহারকারীদের কেনাকাটা করার জন্য রিটেলারদের ওয়েবসাইটে ডাইরেক্ট করে। API কল করার সময়, আপনি যে নির্দিষ্ট CSS গ্রুপ, CSS ডোমেন, অ্যাকাউন্ট বা সাব-অ্যাকাউন্ট যাচাই করেন সেগুলির উপর কোটা প্রয়োগ করা হয়।

  উদাহরণ:

  • ইউরোপ শপিং গ্রুপ (অ্যাকাউন্ট আইডি: 10001) নামের একটি CSS গ্রুপ তার সাথে যুক্ত CSS ডোমেন তালিকাভুক্ত করতে চায়। এই API কল করার জন্য নিজস্ব ক্রেডেনশিয়াল দিয়ে যাচাই করার মাধ্যমে, কোটা সরাসরি ইউরোপ শপিং গ্রুপ কোটা পুল থেকে ব্যবহার করা হয়।
  • একটি CSS ডোমেন TopDeals CSS (অ্যাকাউন্ট আইডি: 20002) একটি লেবেল অ্যাসাইন করার জন্য এর সাথে যুক্ত মার্চেন্ট অ্যাকাউন্টের (accounts/30003) একটি মেথড কল করার জন্য যাচাই করে। কোটা TopDeals CSS-এর কোটা পুল থেকে ব্যবহার করা হয়, মার্চেন্ট অ্যাকাউন্টের পুল থেকে নয়।

• মার্কেটপ্লেস: মার্কেটপ্লেস হল অনলাইন প্ল্যাটফর্ম যা একাধিক ব্যক্তিগত মার্চেন্টকে হোস্ট করে। এগুলি বিশেষ উন্নত অ্যাকাউন্ট হিসেবে কাজ করে যা আপনাকে প্রতিটি বিক্রেতার জন্য আলাদা আলাদা সাব-অ্যাকাউন্ট তৈরি করতে দেয়।

নিচের ডায়াগ্রামে CSS গ্রুপ, CSS, মার্কেটপ্লেস, উন্নত অ্যাকাউন্ট, স্বতন্ত্র অ্যাকাউন্ট ও সাব-অ্যাকাউন্টের হায়ারার্কি দেখানো হয়েছে।

অটোমেটিক কোটা অ্যাডজাস্টমেন্ট

Merchant API-তে নির্দিষ্ট পরিষেবার জন্য অটোমেটিক কোটা ম্যানেজমেন্ট সিস্টেম আছে, যা আপনার ব্যবহার, অফার ও অ্যাকাউন্টের সাইজের উপর ভিত্তি করে ক্রমবর্ধমান মার্চেন্টদের জন্য কোটার সীমা অ্যাডজাস্ট করে। Merchant API প্রতিদিন এই কোটা আবার গণনা করে।

অটোমেটিক কোটা অ্যাডজাস্টমেন্টে অন্তর্ভুক্ত কোটা গ্রুপগুলি হল:

প্রোডাক্ট পরিষেবা

• products ও productInputs রিসোর্স সম্পর্কিত পদ্ধতির সব কোটা গ্রুপ।
• সাধারণত, মার্চেন্টের কাছে যতগুলি অফার কোটা আছে, তার ২ গুণ কল কোটা প্রতিদিন সেট করা হয়। এর অর্থ হল, কোনও মার্চেন্টকে তার প্রতিটি প্রোডাক্ট দিনে দু'বার পর্যন্ত আপডেট করতে হতে পারে।
• এক একটি প্রোডাক্ট দু'বারের বেশি আপডেট করা গেলেও, আপনার সামগ্রিক দৈনিক এপিআই কল, দৈনিক কল কোটার মোট সংখ্যার বেশি হতে পারবে না।

অ্যাকাউন্ট পরিষেবা

• Merchant API-তে বিভিন্ন গ্র্যানুলার অ্যাকাউন্ট-সম্পর্কিত রিসোর্সের সাথে সম্পর্কিত পদ্ধতির সব কোটা গ্রুপ।
• প্রতিদিন কল করার কোটা সেই অ্যাকাউন্টের জন্য অনুমোদিত সর্বাধিক সাব-অ্যাকাউন্টের সংখ্যায় সেট করা আছে। এর ফলে প্রতিটি সাব-অ্যাকাউন্ট থেকে দিনে সর্বাধিক দু'বার কল লগ রিড করা যায়।

ডেটা সোর্স পরিষেবা

• list বা create-এর মতো Merchant API-তে ডেটা সোর্স সম্পর্কিত রিসোর্সের সাথে সম্পর্কিত সব কোটা গ্রুপ যা কোনও উন্নত অ্যাকাউন্ট তার সাব-অ্যাকাউন্টে পারফর্ম করে।
• সাধারণত, অ্যাডভান্সড অ্যাকাউন্টে যতগুলি সাব-অ্যাকাউন্ট আছে, দৈনিক কল কোটা তার দ্বিগুণ হিসেবে সেট করা হয়। এর অর্থ হল, কোনও মার্চেন্ট তার প্রতিটি সাব-অ্যাকাউন্টের' ডেটা সোর্স দিনে দু'বার পর্যন্ত আপডেট করতে পারবেন।

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

কোটা শেষ হয়ে গেলে কী হয়

কোটা পেরিয়ে গেলে, API উত্তর এবং আপনার Merchant Center অ্যাকাউন্টের মধ্যে ডায়াগনস্টিক পৃষ্ঠায় সমস্যা দেখা যাবে:

• প্রতি মিনিট: quota/request_rate_too_high

{
    "error": {
        "code": 429,
        "message": "Quota per minute exceeded. Please distribute your requests over a longer time period. For more information check https://developers.google.com/merchant/api/guides/quotas-limits",
        "status": "RESOURCE_EXHAUSTED",
        "details": [
            {
                "@type": "type.googleapis.com/google.rpc.ErrorInfo",
                "reason": "quotaExceeded",
                "domain": "merchantapi.googleapis.com",
                "metadata": {
                    "HELP_CENTER_LINK": "https://developers.google.com/merchant/api/guides/quotas-limits",
                    "REASON": "QUOTA_REQUEST_RATE_TOO_HIGH"
                }
            }
        ]
    }
}

• প্রতিদিন: quota/daily_limit_exceeded

{
    "error": {
        "code": 429,
        "message": "Daily request quota exceeded. Please reduce number of requests. For more information check https://developers.google.com/merchant/api/guides/quotas-limits",
        "status": "RESOURCE_EXHAUSTED",
        "details": [
            {
                "@type": "type.googleapis.com/google.rpc.ErrorInfo",
                "reason": "quotaExceeded",
                "domain": "merchantapi.googleapis.com",
                "metadata": {
                    "HELP_CENTER_LINK": "https://developers.google.com/merchant/api/guides/quotas-limits",
                    "REASON": "QUOTA_TOO_MANY_REQUESTS"
                }
            }
        ]
    }
}

নিচে উল্লেখ করা সমস্যাগুলি Merchant Center-এর সীমা সংক্রান্ত এবং এগুলি Merchant API কোটার সাথে সম্পর্কিত নয়। আপনি আইটেম, ফিড বা সাব-অ্যাকাউন্টের অতিরিক্ত কোটার জন্য অনুরোধ করতে পারেন:

• too_many_items: মার্চেন্ট কোটা পেরিয়ে গেছে
• too_many_subaccounts: সাব-অ্যাকাউন্টের সর্বাধিক সংখ্যায় পৌঁছে গেছে

মনিটরিং ও দৃশ্যমানতা

কোনও অ্যাকাউন্টের বর্তমান কল কোটা ও ব্যবহার চেক করতে, অ্যাকাউন্টের নাম সহ quotas.list নম্বরে কল করুন।

POST https://merchantapi.googleapis.com/quota/v1/accounts/{ACCOUNT_ID}/quotas
Content-Type: application/json
Authorization: Bearer {ACCESS_TOKEN}

নিম্নলিখিত বিষয়গুলি পরিবর্তন করুন:

• ACCOUNT_ID: আপনার Merchant Center আইডি
• ACCESS_TOKEN: API কল করার জন্য অনুমোদন টোকেন

অনুরোধ সফল হলে, API quotaGroups সম্পদের একটি তালিকা রিটার্ন করে, যার মধ্যে কোটা গ্রুপের রিসোর্স name, বিভিন্ন কোটা এবং সেইসব পদ্ধতি থাকে যেগুলিতে গ্রুপ কোটা প্রযোজ্য হয়।

{
    "quotaGroups": [
        {
            "name": "accounts/{ACCOUNT_ID}/quotas/merchant-quota-listquotagroups",
            "quotaUsage": "2",
            "quotaLimit": "1000",
            "methodDetails": [
                {
                    "method": "quotaservice.listquotagroups",
                    "version": "v1",
                    "subapi": "quota",
                    "path": "quota/v1/quotaservice.listquotagroups"
                }
            ],
            "quotaMinuteLimit": "10"
        },
        {
            "name": "accounts/{ACCOUNT_ID}/quotas/merchant-commission-group-list",
            "quotaLimit": "10000",
            "methodDetails": [
                {
                    "method": "commissiongroupservice.listcommissiongroups",
                    "version": "v1",
                    "subapi": "youtube",
                    "path": "youtube/v1/commissiongroupservice.listcommissiongroups"
                }
            ],
            "quotaMinuteLimit": "60"
        },
        {
            "name": "accounts/{ACCOUNT_ID}/quotas/merchant-merchantreviews-list",
            "quotaLimit": "20000000",
            "methodDetails": [
                {
                    "method": "merchantreviewsservice.listmerchantreviews",
                    "version": "v1",
                    "subapi": "reviews",
                    "path": "reviews/v1/merchantreviewsservice.listmerchantreviews"
                }
            ],
            "quotaMinuteLimit": "60000"
        }
    ]
}

কোটা বাড়ানোর প্রসেস

অতিরিক্ত কোটার অনুরোধ করতে, সহায়তা টিমের সাথে যোগাযোগ করার ফর্ম খুলুন, প্রয়োজনীয় "কী সমস্যা/প্রশ্ন" ফিল্ডের জন্য কোটা বাড়ানোর অনুরোধ বেছে নিন এবং আপনার Merchant Center আইডি, টার্গেট পদ্ধতি ও ব্যবসার যৌক্তিকতা সহ সব প্রয়োজনীয় ফিল্ড পূরণ করুন।

• অটোমেটিক কোটা সহ রিসোর্সের জন্য (products, accounts এবং উন্নত অ্যাকাউন্টের জন্য datasources)): আপনি শুধুমাত্র সাময়িক বৃদ্ধির অনুরোধ করতে পারবেন। এটি নতুন মার্কেটে লঞ্চ করা বা হাই-ট্রাফিক শপিং সিজনের মতো বিশেষ পরিস্থিতির জন্য করা হয়। এই ধরনের রিসোর্সের জন্য আমরা স্থায়ীভাবে কোটা বাড়ানোর অনুরোধ গ্রহণ করি না।
• অটোমেটিক কোটা নেই এমন অন্যান্য রিসোর্সের জন্য: প্রয়োজন অনুযায়ী কোটা বৃদ্ধি করার অনুরোধ করা হয়।

আমরা সাজেস্ট করি যে, আপনার প্রয়োগের জন্য পর্যাপ্ত কোটা আছে কিনা তা নিশ্চিত করতে এবং কীভাবে আপনার কোটা অটোমেটিক অ্যাডজাস্ট করা হয় তা দেখতে, মাঝে মাঝে আপনার কোটা চেক করুন। আপনার বর্তমান দৈনিক কোটা সীমা, মিনিট সীমা এবং প্রতিটি API মেথড গ্রুপের জন্য বর্তমান দৈনিক ব্যবহার দেখতে quotas.list পদ্ধতি ব্যবহার করুন।

পেশাদার পদ্ধতি

এইসব পেশাদার পদ্ধতি প্রয়োগ করলে, আপনার ইন্টিগ্রেশন যাতে মসৃণভাবে চলে, আশা না করা কোটা সংক্রান্ত সমস্যা এড়ানো যায় এবং Merchant Center রিসোর্স দক্ষতার সাথে ব্যবহার করা যায় তা নিশ্চিত করতে সাহায্য করে।

অনুরোধ ডিস্ট্রিবিউশন অপ্টিমাইজ করা

• অনুরোধ সমানভাবে স্প্রেড করুন: একসাথে অনেক অনুরোধ পাঠানো এড়িয়ে চলুন। প্রতি মিনিটের কোটা সীমার (quotaMinuteLimit) মধ্যে থাকতে, আপনার দৈনিক API কলগুলি সারা দিন ধরে সমানভাবে স্প্রেড করুন।
• আগাম থ্রটলিং: আপনার অ্যাপ্লিকেশনে ক্লায়েন্ট-সাইড রেট সীমিত করা (থ্রটলিং) প্রয়োগ করুন। অতিরিক্ত ট্রাফিক প্রত্যাখ্যান করার জন্য শুধুমাত্র Google-এর সার্ভারের উপর নির্ভর করবেন না। সোর্সে আপনার অনুরোধের হার নিয়ন্ত্রণ করুন।

সাবলীলভাবে সমস্যার সমাধান করা

• HTTP 429 ম্যানেজ করা: আপনার অ্যাপ্লিকেশনকে অবশ্যই 429 Too Many Requests সংক্রান্ত সমস্যা (quota/request_rate_too_high) ম্যানেজ করার জন্য প্রস্তুত থাকতে হবে।
• জিটার সহ এক্সপোনেনশিয়াল ব্যাকঅফ: ব্যর্থ অনুরোধ আবার চেষ্টা করার সময় (বিশেষ করে 429 স্ট্যাটাস কোড পাওয়ার পরে), এক্সপোনেনশিয়াল ব্যাকঅফ (অপেক্ষা করার সময় বাড়ানো) ব্যবহার করুন এবং "জিটার" (এলোমেলো বিলম্ব) যোগ করুন। "রিট্রাই স্টর্ম" প্রতিরোধ করতে জিটার ব্যবহার করা হয়। এর ফলে অনেক ক্লায়েন্ট ইনস্ট্যান্স একই সময়ে আবার চেষ্টা করে না এবং সার্ভার ওভারলোড হয় না।
• আবার চেষ্টা করার ইঙ্গিত মেনে চলুন: API-এর উত্তরে আবার চেষ্টা করার বিবরণ বা হেডার থাকলে, কল কখন আবার শুরু করতে হবে তা নির্ধারণ করতে সেগুলি ব্যবহার করুন।

অপ্রয়োজনীয় কল কমানো

• পুরনো কল আটকানো (404 NOT_FOUND): আর নেই এমন রিসোর্স অনুরোধ করা বা মুছে দেওয়া এড়িয়ে চলুন। এমনকি কল করা না গেলেও API কোটা ব্যবহার করা হয়। পুরনো স্টেট ট্র্যাকিং বা অপ্রয়োজনীয় পোলিং শনাক্ত করতে Merchant Center API ডায়াগনস্টিকসে NOT_FOUND হওয়া সমস্যা মনিটর করুন।
• আপডেট করার আগে যাচাই করুন: আপডেট করার অনুরোধ পাঠানোর আগে, চেক করে দেখুন যে ডেটা আসলে পরিবর্তিত হয়েছে কিনা। একই ভ্যালু লেখা হয় এমন আপডেট পাঠানো এড়িয়ে চলুন।
• ক্যাশিং ব্যবহার করা: অপরিবর্তিত ডেটার জন্য বারবার get বা list কল এড়াতে উপযুক্ত হলে, স্থানীয়ভাবে ক্যাশে রিড রেসপন্স (যেমন, প্রোডাক্টের বিবরণ, সেটিংস) সেভ করুন।

কোটা হায়ারার্কি ও ব্যতিক্রম নেভিগেট করা

• উন্নত অ্যাকাউন্ট ও সাব-অ্যাকাউন্ট: আপনি উন্নত অ্যাকাউন্ট হলে, উন্নত অ্যাকাউন্টের শেয়ার করা পুলের বিপরীতে কল গণনা করতে চাইলে উন্নত অ্যাকাউন্ট লেভেলে যাচাই করুন।
• ব্যবহার করুন listSubaccounts: উন্নত অ্যাকাউন্টের জন্য, accounts.list-এর পরিবর্তে accounts.listSubaccounts ব্যবহার করুন। কলিং ব্যবহারকারীকে (MC ID নয়) accounts.list কোটা চার্জ করা হয় এবং এটি স্ট্যান্ডার্ড ডায়াগনস্টিক্সে দেখা যায় না। listSubaccounts আপনার MCA কোটার মধ্যে ধরা হয়।