কোটা

এই নথিতে মার্চেন্ট এপিআই-এর ক্ষেত্রে প্রযোজ্য কোটাগুলো তালিকাভুক্ত করা হয়েছে।

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

সাধারণ ধারণা

মার্চেন্ট এপিআই কোটা কোটা গ্রুপের মাধ্যমে পরিচালিত হয়।

এপিআই মেথডগুলোকে কোটা গ্রুপের সাথে ম্যাপ করা হয়। এই ম্যাপিংয়ের কাঠামো ভিন্ন হতে পারে:

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

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

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

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

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

নীতি হালনাগাদ করুন

মার্চেন্ট এপিআই আপডেটের ক্ষেত্রে নিম্নলিখিত নীতিমালা প্রয়োগ করে:

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

রেট কোটা

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

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

আপনি quotas.list মেথডের রেসপন্সে পূর্বে বর্ণিত তিনটি ফিল্ড ( quotaLimit , quotaMinuteLimit , এবং quotaUsage ) খুঁজে পাবেন।

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

কোটা বরাদ্দ এবং ক্রমবিন্যাস

এই বিভাগে ব্যাখ্যা করা হয়েছে যে মার্চেন্ট এপিআই কার পক্ষ থেকে কোটা ব্যবহারের তথ্য রাখে এবং তা প্রয়োগ করে:

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

  • স্বতন্ত্র অ্যাকাউন্ট: স্বতন্ত্র অ্যাকাউন্ট দ্বারা কোনো এপিআই কল প্রমাণীকরণের ক্ষেত্রে, সেই অনুরোধটি সেই অ্যাকাউন্টের কোটার আওতা থেকে গণনা করা হয়।
    • উদাহরণ: একজন মার্চেন্ট , শু স্টোর এ (অ্যাকাউন্ট আইডি: ১২৩৪৫), তার নিজের সার্ভিস অ্যাকাউন্ট ব্যবহার করে প্রমাণীকরণের মাধ্যমে তার নিজের অ্যাকাউন্টকে ( accounts/12345 ) টার্গেট করে products.insert কল করে। কোটাটি শু স্টোর এ-এর কোটা পুল থেকে ব্যবহৃত হয়।
  • অ্যাডভান্সড-অ্যাকাউন্ট: একটি সাব-অ্যাকাউন্টকে টার্গেট করা হলেও, অ্যাডভান্সড অ্যাকাউন্ট হিসেবে প্রমাণীকরণ করলে সেই অ্যাকাউন্টের পুল থেকে কোটা ব্যবহৃত হয়।
    • উদাহরণ: একটি এজেন্সির রিটেইল ম্যানেজমেন্ট অ্যাকাউন্ট (অ্যাডভান্সড অ্যাকাউন্ট আইডি: 12345) একটি সাব-অ্যাকাউন্ট ‘ক্লোথিং স্টোর বি’ (অ্যাকাউন্ট আইডি: 11111) পরিচালনা করে। এজেন্সিটি তার নিজস্ব ক্রেডেনশিয়াল ব্যবহার করে প্রমাণীকরণ করে এবং ‘ক্লোথিং স্টোর বি’ ( accounts/11111 ) টার্গেট করে products.insert কল করে। কোটাটি সাব-অ্যাকাউন্টের পুল থেকে নয়, বরং প্যারেন্ট এজেন্সির (অ্যাডভান্সড অ্যাকাউন্ট আইডি: 12345) পুল থেকে ব্যবহৃত হয়।
  • সাব-অ্যাকাউন্ট: যখন কোনো সাব-অ্যাকাউন্টের ক্রেডেনশিয়াল ব্যবহার করে এপিআই কলগুলো প্রমাণীকরণ করা হয়, তখন কোটা সেই সাব-অ্যাকাউন্টের নিজস্ব পুল থেকে চার্জ করা হয়। এটি একটি প্যারেন্ট অ্যাডভান্সড অ্যাকাউন্ট দ্বারা পরিচালিত হলেও, এটি একটি স্বতন্ত্র অ্যাকাউন্টের মতোই কাজ করে।
    • উদাহরণ: আগের মতো একই সেটআপ ব্যবহার করে, যদি ক্লোথিং স্টোর বি (অ্যাকাউন্ট আইডি: 11111) তাদের সাব-অ্যাকাউন্টের জন্য বিশেষভাবে সেট আপ করা ক্রেডেনশিয়াল ব্যবহার করে তাদের নিজস্ব অ্যাকাউন্ট ( accounts/11111 ) টার্গেট করে products.insert কল করার জন্য প্রমাণীকরণ করে, তাহলে কোটা ক্লোথিং স্টোর বি-এর নিজস্ব কোটা পুল থেকে ব্যবহৃত হবে, এবং প্যারেন্ট এজেন্সির পুল অক্ষত থাকবে।

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

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

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

বরাদ্দ ক্রম

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

    উদাহরণ:

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

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

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

একটি CSS গ্রুপ হলো সর্বোচ্চ প্রমাণীকরণ স্তর, যার মধ্যে স্বতন্ত্র CSS, সেগুলোর অধীনে অ্যাকাউন্ট এবং সবচেয়ে স্বতন্ত্র স্তর হিসেবে সাব-অ্যাকাউন্ট থাকার সম্ভাবনা থাকে।

স্বয়ংক্রিয় কোটা সমন্বয়

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

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

পণ্য পরিষেবা

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

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

  • মার্চেন্ট এপিআই-এর বিভিন্ন সূক্ষ্ম অ্যাকাউন্ট-সম্পর্কিত রিসোর্সের সাথে যুক্ত মেথডগুলোর সকল কোটা গ্রুপ।
  • দৈনিক কল কোটা সেই অ্যাকাউন্টের জন্য অনুমোদিত সর্বোচ্চ সংখ্যক সাব-অ্যাকাউন্টের সমান করে নির্ধারণ করা হয়। এর ফলে, প্রতিটি সাব-অ্যাকাউন্ট প্রতিদিন সর্বোচ্চ দুইবার রিড কল ​​করতে পারে।

ডেটা উৎস পরিষেবা

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

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

কোটা অতিক্রম করলে কী হয়

কোটা অতিক্রম করার পর, API রেসপন্সগুলিতে এবং আপনার মার্চেন্ট সেন্টার অ্যাকাউন্টের ডায়াগনস্টিকস পেজে ত্রুটি দেখা যাবে:

  • প্রতি মিনিটে: 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"
                }
            }
        ]
    }
}

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

  • 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 : আপনার মার্চেন্ট সেন্টার আইডি
  • ACCESS_TOKEN : এপিআই কল করার জন্য অনুমোদন টোকেন

একটি সফল অনুরোধের পর, এপিআইটি 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"
        }
    ]
}

কোটা বৃদ্ধি প্রক্রিয়া

অতিরিক্ত কোটার জন্য অনুরোধ করতে, ' Contact support' ফর্মটি খুলুন, প্রয়োজনীয় 'What is the Issue/Question' ফিল্ডের জন্য 'Quota increase request' নির্বাচন করুন এবং আপনার মার্চেন্ট সেন্টার আইডি, টার্গেট মেথড ও ব্যবসায়িক যৌক্তিকতা সহ সমস্ত প্রয়োজনীয় ফিল্ড পূরণ করুন।

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

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

সর্বোত্তম অনুশীলন

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

অনুরোধ বিতরণ অপ্টিমাইজ করুন

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

মার্জিত ত্রুটি পরিচালনা

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

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

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