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

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

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

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

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

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

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

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

প্রতি প্রকল্পের কোটা বৃদ্ধির অনুরোধ করুন

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

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

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