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 |
هر فراخوانی میانای برنامه‌سازی کاربردی به‌عنوان یک درخواست محسوب می‌شود، صرف‌نظر از اندازه صفحه یا، برای روش‌های دسته‌ای، تعداد پیام‌ها در دسته. برای مثال، یک درخواست batchRelease
با ۵۰۰ پیام، یک درخواست نوشتن مصرف می‌کند.
می‌توانید مصرف سهمیه فعلی پروژه‌تان را در کنسول Google Cloud در بخش APIs & Services > Enabled APIs & services > Admin Quarantine API > Quotas & System Limits مشاهده کنید.
محدودیت‌های درخواست
| محدودیت | مقدار |
|---|---|
حداکثر pageSize برای درخواست‌های list و search |
۳۰۰ پیام |
حداکثر پیام‌ها برای هر درخواست 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دریافت می‌کنید، قبل‌از امتحان مجدد صبر کنید و زمان انتظار را بعداز هر تلاش ناموفق افزایش دهید. برای جزئیات، عقب‌گرد نمایی را ببینید. - از بزرگ‌ترین اندازه صفحه مفید استفاده کنید. درخواست‌های جستجو و فهرست کردن کمترین سهمیه را دارند. به‌جای تعداد زیادی صفحه کوچک، حداکثر ۳۰۰ پیام در هر صفحه درخواست کنید.
- از فیلترها استفاده کنید. درخواست‌های
searchرا باfilterیاqueryمحدود کنید تا فقط پیام‌های موردنیازتان را بازیابی کنید. - از روش‌های دسته‌ای برای اقدامات انبوه استفاده کنید. یک درخواست
batchReleaseیاbatchDenyمی‌تواند تا ۵۰۰ پیام را آزاد یا رد کند، درحالی‌که هر تماسreleaseیاdenyفقط یک پیام را آزاد یا رد می‌کند. - عملیات نظرسنجی را به‌ندرت انجام دهید. وقتی منتظر عملیات دسته‌ای هستید،
روش
getمنبعcustomers.operationsرا هر چند ثانیه یک‌بار به‌جای به‌طور مداوم فراخوانی کنید. - همگام‌سازی افزایشی. به‌جای فهرست کردن مجدد کل قرنطینه در هر اجرا،
روی
status = PENDING_TRIAGEفیلتر کنید و فقط پیام‌های جدید را پردازش کنید.
افزایش سهمیه درطول «پیش‌نمای توسعه‌دهندگان نرم‌افزار» دردسترس نیست. اگر مورد استفاده شما به سهمیه‌های بالاتری نیاز دارد، بازخوردتان را ازطریق برنامه پیش‌نمایش توسعه‌دهندگان Google Workspace هم‌رسانی کنید.