সীমা এবং কোটা

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

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

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

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

API সীমা বিভাগ সীমা
QPS এবং QPD হার রিপোর্ট করুন API আপনার Google ক্লাউড প্রকল্পের জন্য অনুরোধের সংখ্যা সীমিত করে। Google ক্লাউড কনসোলে সেট করা ডিফল্ট মান হল Google ক্লাউড প্রকল্প প্রতি ব্যবহারকারী প্রতি মিনিটে 2,400টি প্রশ্ন। আপনি আপনার Google ক্লাউড প্রকল্পের অ্যাডমিন SDK API কোটা পৃষ্ঠা থেকে এই সীমা বাড়াতে পারেন।

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

API কোটা বিভাগ কোটা
সর্বোচ্চ ফলাফল একটি API এর প্রতিক্রিয়ার প্রতিটি পৃষ্ঠায় তালিকাভুক্ত রেকর্ডের সংখ্যা 1 থেকে 1000টি ইভেন্ট। ডিফল্ট 1000 রেকর্ড।

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