Mail Admin Quarantine API ব্যবহারের কোটা

Mail Admin Quarantine API প্রতিটি Google Cloud প্রোজেক্টের জন্য প্রতি মিনিটে ব্যবহারের কোটা এনফোর্স করে যাতে Google Workspace-এর সেইসব পরিকাঠামো সুরক্ষিত থাকে যেগুলি কোয়ারেন্টাইন করা মেসেজ সার্চ করে ও ফিরিয়ে আনে। একটি পদ্ধতি যে ধরনের কাজ করে সেই অনুযায়ী কোটা গ্রুপ করা হয়।

কোটা

নিম্নলিখিত সারণীতে কোটা তালিকাভুক্ত করা হয়েছে। প্রতিটি কোটা প্রতি মিনিটে প্রতি Cloud প্রোজেক্ট হিসেবে গণনা করা হয় এবং প্রোজেক্টটি সমস্ত Google Workspace গ্রাহক এবং ছদ্মবেশী অ্যাডমিনিস্ট্রেটরদের মধ্যে যে সমস্ত অনুরোধ করে তা গণনা করে।

কোটা ভ্যালু পদ্ধতি
অনুরোধ সার্চ ও তালিকাভুক্ত করুন প্রতি মিনিটে ৬০টি অনুরোধ customers.quarantinedMessages.list, customers.quarantinedMessages.search
অনুরোধ পড়ুন প্রতি মিনিটে ১,২০০টি অনুরোধ customers.quarantinedMessages.get, customers.quarantines.get, customers.quarantines.list, customers.operations.get
অনুরোধ লিখুন প্রতি মিনিটে ৩০০টি অনুরোধ customers.quarantinedMessages.release, customers.quarantinedMessages.deny, customers.quarantinedMessages.batchRelease, customers.quarantinedMessages.batchDeny

প্রতিটি API কলকে একটি অনুরোধ হিসেবে গণ্য করা হয়, পৃষ্ঠার সাইজ বা ব্যাচ পদ্ধতির ক্ষেত্রে ব্যাচে মেসেজের সংখ্যা যাই হোক না কেন। যেমন, ৫০০টি মেসেজ সহ batchRelease অনুরোধের জন্য একটি রাইট অনুরোধ খরচ হয়।

আপনি Google Cloud কনসোলে আপনার প্রোজেক্টের বর্তমান কোটা ব্যবহার দেখতে পারবেন, এর জন্য API ও পরিষেবা > চালু করা API ও পরিষেবা > Admin Quarantine API > কোটা ও সিস্টেমের সীমা বিকল্পে যান।

অনুরোধের সীমাবদ্ধতা

সীমাবদ্ধতা ভ্যালু
list ও search অনুরোধের জন্য সর্বাধিক pageSize ৩০০টি মেসেজ
প্রতি batchRelease বা batchDeny অনুরোধে সর্বাধিক মেসেজ ৫০০টি মেসেজ
সার্চ ও তালিকা উইন্ডো গত ৩০ দিনে পাওয়া মেসেজ

কোটা সংক্রান্ত সমস্যার সমাধান করা

আপনার প্রোজেক্ট কোটা অতিক্রম করলে, API এই স্ট্যাটাস সহ HTTP 429 সমস্যা দেখায় RESOURCE_EXHAUSTED:

{
  "error": {
    "code": 429,
    "message": "Quota exceeded for quota metric 'Search and list quarantined messages requests' and limit 'Search and list requests per minute per project' of service 'mailadminquarantine.googleapis.com' for consumer 'project_number:123456789012'.",
    "status": "RESOURCE_EXHAUSTED"
  }
}

কোটার মধ্যে থাকতে:

  • এক্সপোনেনশিয়াল ব্যাক-অফ সহ আবার চেষ্টা করুন। 429 সমস্যা হলে, আবার চেষ্টা করার আগে অপেক্ষা করুন এবং প্রতিবার চেষ্টা করার পরে অপেক্ষা করার সময় বাড়ান। আরও বিবরণের জন্য, এক্সপোনেনশিয়াল ব্যাক-অফ দেখুন।
  • সবচেয়ে বড় উপযোগী পৃষ্ঠার সাইজ ব্যবহার করুন। সার্চ ও তালিকা সংক্রান্ত অনুরোধের কোটা সবচেয়ে কম। অনেক ছোট পৃষ্ঠার পরিবর্তে পৃষ্ঠা প্রতি ৩০০টি পর্যন্ত মেসেজের অনুরোধ করুন।
  • ফিল্টার ব্যবহার করুন। filter বা query-এর সাথে search অনুরোধের সংখ্যা কমান যাতে আপনি শুধুমাত্র প্রয়োজনীয় মেসেজই পান।
  • বাল্ক অ্যাকশনের জন্য ব্যাচ পদ্ধতি ব্যবহার করুন। একটি batchRelease বা batchDeny অনুরোধের মাধ্যমে সর্বাধিক ৫০০টি মেসেজ রিলিজ বা বাতিল করা যেতে পারে, যেখানে প্রতিটি release বা deny কলের মাধ্যমে একটি করে মেসেজ রিলিজ বা বাতিল করা যায়।
  • পোল অপারেশন কম করুন। আপনি যখন কোনও ব্যাচ অপারেশনের জন্য অপেক্ষা করেন, তখন ক্রমাগত না করে প্রতি কয়েক সেকেন্ডে customers.operations রিসোর্সের get পদ্ধতি কল করুন।
  • ইনক্রিমেন্টাল সিঙ্ক করুন। প্রতিবার রান করার সময় সম্পূর্ণ কোয়ারেন্টাইন আবার তালিকাভুক্ত করার পরিবর্তে, status = PENDING_TRIAGE-এ ফিল্টার করুন এবং শুধুমাত্র নতুন মেসেজ প্রসেস করুন।

ডেভেলপার প্রিভিউ চলাকালীন কোটা বাড়ানো যাবে না। আপনার ব্যবহারের ক্ষেত্রে আরও বেশি কোটার প্রয়োজন হলে, Google Workspace ডেভেলপার প্রিভিউ প্রোগ্রাম-এর মাধ্যমে আপনার মতামত শেয়ার করুন।