ব্যবহারের সীমা এবং কোটা

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

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

যদি আপনার অনুরোধগুলি একটি নির্দিষ্ট সময়ের মধ্যে সম্পন্ন করার প্রয়োজন হয়, তবে আপনার জাভা বা সি# অ্যাপ্লিকেশনে অনুরোধগুলি সমান্তরালভাবে পাঠান বা একাধিক থ্রেড ব্যবহার করুন। সমান্তরাল অনুরোধের একটি উদাহরণ হলো, একজন ব্যবহারকারীর থেকে একবারে অনেক ইমেল যোগ বা অপসারণ না করে, বিভিন্ন ব্যবহারকারীর কাছ থেকে অল্প অল্প করে ইমেলের অনুরোধ করা। থ্রেডের ক্ষেত্রে, ১০টি থ্রেড দিয়ে শুরু করার চেষ্টা করুন, প্রতিটি ব্যবহারকারীর ইমেলের জন্য একটি করে থ্রেড। মনে রাখবেন, থ্রেড ব্যবহারের এই সুপারিশের কিছু সীমাবদ্ধতা রয়েছে এবং এটি সব API পরিস্থিতির জন্য উপযোগী নয়। অনুরোধের সংখ্যা খুব বেশি হয়ে গেলে কোটা ত্রুটি দেখা দেবে।

সময়-ভিত্তিক সমস্ত ত্রুটির (প্রতি থ্রেডে N সেকেন্ডের জন্য সর্বোচ্চ Nটি বিষয়) ক্ষেত্রে, বিশেষ করে 503 স্ট্যাটাস কোড ত্রুটির জন্য, আমরা সুপারিশ করি যে আপনার কোড যেন এক্সেপশনটি ক্যাচ করে এবং একটি এক্সপোনেনশিয়াল ব্যাকঅফ অ্যালগরিদম ব্যবহার করে, ব্যর্থ কলটি পুনরায় চেষ্টা করার আগে অল্প কিছুক্ষণ অপেক্ষা করে। একটি থ্রেডের জন্য অ্যালার্ট সেন্টার এপিআই-এর একটি উদাহরণ হলো ৫ সেকেন্ড অপেক্ষা করে ব্যর্থ কলটি পুনরায় চেষ্টা করা। যদি অনুরোধটি সফল হয়, তবে অন্য থ্রেডগুলোর জন্য এই পদ্ধতিটি পুনরাবৃত্তি করুন। যদি দ্বিতীয় অনুরোধটিও সফল না হয়, তবে একটি কল সফল না হওয়া পর্যন্ত আপনার অ্যাপ্লিকেশনটির অনুরোধের সংখ্যা কমিয়ে আনা উচিত। উদাহরণস্বরূপ, প্রাথমিক ৫ সেকেন্ডের বিলম্ব বাড়িয়ে ১০ সেকেন্ড করুন এবং আপনার ব্যর্থ কলটি আবার চেষ্টা করুন। এছাড়াও, পুনরায় চেষ্টার একটি সীমা নির্ধারণ করুন। উদাহরণস্বরূপ, আপনার অ্যাপ্লিকেশনটি ব্যবহারকারীকে কোনো ত্রুটি দেখানোর আগে, বিভিন্ন বিলম্বের সময় ব্যবহার করে একটি অনুরোধ ৫ থেকে ৭ বার পুনরায় চেষ্টা করতে পারে।

এপিআই সীমা বিভাগ সীমা
অ্যালার্ট সেন্টার QPS এবং QPD রেট এপিআই আপনার গুগল ক্লাউড প্রজেক্টের জন্য অনুরোধের সংখ্যা সীমিত করে। এপিআই প্রজেক্টের প্রতি সেকেন্ডে সর্বোচ্চ অনুরোধের সংখ্যা (প্রজেক্ট কিউপিএস) হলো ১০০০। এবং, প্রতি ব্যবহারকারী প্রতি সেকেন্ডে সর্বোচ্চ অনুরোধের সংখ্যা (ইউজার কিউপিএস) হলো ১৫০।

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

অন্যান্য ধরণের সীমা সীমাবদ্ধতা এবং নির্দেশিকা
ডেটা ফরম্যাট, ডিফল্ট ডিফল্ট ডেটা ফরম্যাট হলো JSON।
অননুমোদিত অনুরোধ গুগল এই এপিআই-তে অননুমোদিত অনুরোধের অনুমতি দেয় না। কোনো অনুমোদন টোকেন প্রদান করা না হলে, অনুরোধটিকে অননুমোদিত বলে গণ্য করা হয়। আরও তথ্যের জন্য, অনুরোধ অনুমোদন (Authorizing requests) দেখুন।

প্রকল্প-ভিত্তিক কোটা বৃদ্ধির জন্য অনুরোধ করুন

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

সব প্রোজেক্টের কোটা এক নয়। সময়ের সাথে সাথে আপনার গুগল ক্লাউডের ব্যবহার বাড়ার সাথে সাথে আপনার কোটার পরিমাণও বৃদ্ধি করার প্রয়োজন হতে পারে। যদি আপনি ভবিষ্যতে ব্যবহারের উল্লেখযোগ্য বৃদ্ধি প্রত্যাশা করেন, তবে আপনি গুগল ক্লাউড কনসোলের 'Quotas & System Limits' পেজ থেকে আগে থেকেই কোটা সমন্বয়ের জন্য অনুরোধ করতে পারেন।

আরও জানতে, নিম্নলিখিত উৎসগুলো দেখুন: