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

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

আপনি একটি কোটা অতিক্রম করলে, আপনি সাধারণত একটি 429: Too many requests HTTP স্থিতি কোড প্রতিক্রিয়া। যদি এটি ঘটে, আপনার একটি সূচকীয় ব্যাকঅফ অ্যালগরিদম ব্যবহার করা উচিত এবং পরে আবার চেষ্টা করা উচিত।

নিম্নলিখিত সারণী অনুরোধের সীমার বিবরণ:

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

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

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

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

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

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

  1. Google ডক্স 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 সময়ে পৌঁছে যাওয়ার পরে পুনরায় চেষ্টা চালিয়ে যেতে পারে। এই পয়েন্টের পরে পুনরায় চেষ্টা করলে ব্যাকঅফ সময় বাড়ানোর প্রয়োজন নেই। উদাহরণস্বরূপ, যদি একটি ক্লায়েন্ট maximum_backoff 64 সেকেন্ডের ব্যাকঅফ সময় ব্যবহার করে, তাহলে এই মানটিতে পৌঁছানোর পরে, ক্লায়েন্ট প্রতি 64 সেকেন্ডে পুনরায় চেষ্টা করতে পারে। কিছু সময়ে, ক্লায়েন্টদের অনির্দিষ্টকালের জন্য পুনরায় চেষ্টা করা থেকে বিরত রাখা উচিত।

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

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

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

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

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

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

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