ব্যবহারের সীমা

যেহেতু Google Sheets API একটি শেয়ার করা পরিষেবা, তাই আমরা কোটা এবং সীমাবদ্ধতা প্রয়োগ করি যাতে নিশ্চিত করা যায় যে এটি সমস্ত ব্যবহারকারীর দ্বারা ন্যায্যভাবে ব্যবহার করা হচ্ছে এবং Google Workspace সিস্টেমের সামগ্রিক স্বাস্থ্য রক্ষা করতে।

কোটার সীমা

যদিও শীট এপিআই একটি এপিআই অনুরোধের জন্য কোন হার্ড সাইজ সীমা নেই, ব্যবহারকারীরা শীট দ্বারা নিয়ন্ত্রিত নয় এমন বিভিন্ন প্রক্রিয়াকরণ উপাদান থেকে সীমা অনুভব করতে পারে। অনুরোধের গতি বাড়ানোর জন্য, Google সর্বাধিক 2-MB পেলোডের সুপারিশ করে৷

শীট এপিআই-এর প্রতি মিনিটের কোটা রয়েছে এবং সেগুলি প্রতি মিনিটে পুনরায় পূরণ করা হয়। উদাহরণস্বরূপ, প্রতি প্রকল্পে প্রতি মিনিটে 300 পড়ার অনুরোধের সীমা রয়েছে। যদি আপনার অ্যাপ এক মিনিটে 350টি অনুরোধ পাঠায়, অতিরিক্ত 50টি অনুরোধ কোটা অতিক্রম করে এবং একটি 429: Too many requests HTTP স্ট্যাটাস কোডের প্রতিক্রিয়া। যদি এটি ঘটে, আপনার একটি সূচকীয় ব্যাকঅফ অ্যালগরিদম ব্যবহার করা উচিত। 1 মিনিটের পরে, আপনি আবার অনুরোধগুলি চালাতে পারেন। ব্যবহারকারীরা একই সময়ে একাধিক অনুরোধ জমা দিতে পারে, যতক্ষণ না তারা কোটা সীমার মধ্যে থাকে।

সমস্ত পত্রক অনুরোধ পারমাণবিকভাবে প্রয়োগ করা হয়। অর্থাৎ, যদি কোনো অনুরোধ বৈধ না হয় তাহলে সম্পূর্ণ আপডেট ব্যর্থ হয় এবং (সম্ভাব্যভাবে নির্ভরশীল) পরিবর্তনগুলির কোনোটিই প্রয়োগ করা হয় না।

নিম্নলিখিত সারণী অনুরোধ সীমা বিশদ বিবরণ. আপনি প্রতি-মিনিট কোটার মধ্যে থাকার শর্তে, আপনি প্রতিদিন করতে পারেন এমন অনুরোধের সংখ্যার কোন সীমা নেই।

কোটা
অনুরোধ পড়ুন
প্রকল্প প্রতি মিনিট প্রতি 300
প্রকল্প প্রতি ব্যবহারকারী প্রতি মিনিট প্রতি 60
অনুরোধ লিখুন
প্রকল্প প্রতি মিনিট প্রতি 300
প্রকল্প প্রতি ব্যবহারকারী প্রতি মিনিট প্রতি 60

ফাইলের সীমা সম্পর্কে বিশদ বিবরণের জন্য, আপনি Google ড্রাইভে সংরক্ষণ করতে পারেন এমন ফাইলগুলিতে যান৷

সময়-ভিত্তিক কোটা ত্রুটিগুলি সমাধান করুন

সমস্ত সময়-ভিত্তিক ত্রুটির জন্য (প্রতি X মিনিটে সর্বাধিক N অনুরোধ), আমরা সুপারিশ করি যে আপনার কোডটি ব্যতিক্রম ক্যাচ করে এবং আপনার ডিভাইসগুলি অত্যধিক লোড তৈরি না করে তা নিশ্চিত করার জন্য একটি ছোট সূচক ব্যাকঅফ ব্যবহার করুন৷

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

উদাহরণ অ্যালগরিদম

একটি সূচকীয় ব্যাকঅফ অ্যালগরিদম দ্রুততার সাথে পুনরায় চেষ্টা করে, পুনঃপ্রচারের মধ্যে অপেক্ষার সময়কে সর্বোচ্চ ব্যাকঅফ সময় পর্যন্ত বাড়িয়ে দেয়। যেমন:

  1. Google Sheets API-কে একটি অনুরোধ করুন।
  2. অনুরোধ ব্যর্থ হলে, 1 + random_number_milliseconds অপেক্ষা করুন এবং অনুরোধটি পুনরায় চেষ্টা করুন।
  3. অনুরোধ ব্যর্থ হলে, 2 + random_number_milliseconds অপেক্ষা করুন এবং অনুরোধটি পুনরায় চেষ্টা করুন।
  4. অনুরোধ ব্যর্থ হলে, 4 + random_number_milliseconds অপেক্ষা করুন এবং অনুরোধটি পুনরায় চেষ্টা করুন।
  5. এবং তাই, maximum_backoff সময় পর্যন্ত।
  6. কিছু সর্বোচ্চ সংখ্যক পুনঃপ্রচেষ্টা পর্যন্ত অপেক্ষা করা এবং পুনরায় চেষ্টা করা চালিয়ে যান, তবে পুনরায় চেষ্টার মধ্যে অপেক্ষার সময় বাড়াবেন না।

কোথায়:

  • অপেক্ষার সময় হল min(((2^n)+random_number_milliseconds), maximum_backoff) , প্রতিটি পুনরাবৃত্তির (অনুরোধ) জন্য n 1 দ্বারা বৃদ্ধি করা হয়েছে।
  • random_number_milliseconds হল 1,000 এর থেকে কম বা সমান মিলিসেকেন্ডের একটি এলোমেলো সংখ্যা। এটি এমন ঘটনাগুলি এড়াতে সাহায্য করে যেখানে অনেক ক্লায়েন্ট কিছু পরিস্থিতির দ্বারা সিঙ্ক্রোনাইজ করা হয় এবং সিঙ্ক্রোনাইজড তরঙ্গে অনুরোধ পাঠানোর জন্য একবারে পুনরায় চেষ্টা করুন। random_number_milliseconds মান প্রতিটি পুনরায় চেষ্টা করার অনুরোধের পরে পুনরায় গণনা করা হয়।
  • maximum_backoff সাধারণত 32 বা 64 সেকেন্ড। উপযুক্ত মান ব্যবহারের ক্ষেত্রে নির্ভর করে।

ক্লায়েন্ট maximum_backoff সময়ে পৌঁছে যাওয়ার পরে পুনরায় চেষ্টা চালিয়ে যেতে পারে। এই পয়েন্টের পরে পুনরায় চেষ্টা করলে ব্যাকঅফ সময় বাড়ানোর প্রয়োজন নেই। উদাহরণস্বরূপ, যদি একটি ক্লায়েন্ট সর্বোচ্চ 64 সেকেন্ডের maximum_backoff সময় ব্যবহার করে, তাহলে এই মানটিতে পৌঁছানোর পরে, ক্লায়েন্ট প্রতি 64 সেকেন্ডে পুনরায় চেষ্টা করতে পারে। কিছু সময়ে, ক্লায়েন্টদের অনির্দিষ্টকালের জন্য পুনরায় চেষ্টা করা থেকে বিরত রাখা উচিত।

পুনরায় চেষ্টা এবং পুনঃপ্রচারের সংখ্যার মধ্যে অপেক্ষার সময় আপনার ব্যবহারের ক্ষেত্রে এবং নেটওয়ার্কের অবস্থার উপর নির্ভর করে।

মূল্য নির্ধারণ

Google Sheets API-এর সমস্ত ব্যবহার কোনও অতিরিক্ত খরচ ছাড়াই উপলব্ধ। কোটা অনুরোধের সীমা অতিক্রম করলে অতিরিক্ত চার্জ লাগে না এবং আপনার অ্যাকাউন্টে বিল করা হয় না।

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

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

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

আরও জানতে, নিম্নলিখিত সংস্থানগুলি দেখুন: