محدودیت‌ها و سهمیه‌ها

برای درک محدودیت‌ها و سهمیه‌ها هنگام کار با Data Manager API، این راهنما را دنبال کنید.

محدودیت‌های پروژه

برای استفاده از Data Manager API به پروژه Google Cloud نیاز دارید. پروژه Google Cloud مشتری و اطلاعات اعتباری OAuth را که برای احراز هویت درخواست‌های API استفاده می‌کنید ارائه می‌دهد.

‫Data Manager API حدود نرخ را برای هر پروژه Google Cloud براساس نوع سرویس و عملیات (خواندن دربرابر تغییر دادن) اعمال می‌کند:

سرویس عملیات درخواست‌ها در روز درخواست در دقیقه
IngestionService جهش (نوشتن) ۱۰۰٬۰۰۰ ۳۰۰
IngestionService خواندن ۱۰۰٬۰۰۰ ۳۰۰
همه سرویس‌های دیگر ترکیب‌شده جهش (نوشتن) ۵۰٬۰۰۰ ۳۰۰
همه سرویس‌های دیگر ترکیب‌شده خواندن ۵۰٬۰۰۰ ۳۰۰

درخواست‌هایی که از حد مجاز فراتر بروند با خطای RESOURCE_EXHAUSTED و وضعیت HTTP 429 Too Many Requests رد می‌شوند.

با هر دو روش فعالانه کاهش تعداد درخواست‌ها و محدود کردن QPS از سمت مشتری می‌توانید کنترل برنامه‌تان را در دست بگیرید و محدودیت‌های نرخ را کاهش دهید. همچنین می‌توانید در کنسول Google Cloud پایش و هشدارهای سهمیه تنظیم کنید تا قبل‌از اینکه برنامه شما به محدودیت‌هایش برسد اعلان دریافت کنید.

نام‌های سهمیه

هر حد با نام حد سهمیه و سنجه در Google Cloud مطابقت دارد. وقتی درخواستی از حد مجاز فراتر می‌رود، «میانای برنامه‌سازی کاربردی مدیر داده» نام حد مجاز را در بار استاندارد جزئیات ErrorInfo در metadata.quota_limit برمی‌گرداند:

نام حد مجاز سهمیه سرویس عملیات پنجره حد
IngestionMutateRequestsPerDayPerProject IngestionService جهش روز ۱۰۰٬۰۰۰
IngestionMutateRequestsPerMinutePerProject IngestionService جهش دقیقه ۳۰۰
IngestionReadRequestsPerDayPerProject IngestionService خواندن روز ۱۰۰٬۰۰۰
IngestionReadRequestsPerMinutePerProject IngestionService خواندن دقیقه ۳۰۰
ManagementMutateRequestsPerDayPerProject همه سرویس‌های دیگر جهش روز ۵۰٬۰۰۰
ManagementMutateRequestsPerMinutePerProject همه سرویس‌های دیگر جهش دقیقه ۳۰۰
ManagementReadRequestsPerDayPerProject همه سرویس‌های دیگر خواندن روز ۵۰٬۰۰۰
ManagementReadRequestsPerMinutePerProject همه سرویس‌های دیگر خواندن دقیقه ۳۰۰

metadata.quota_limit را در محتوای ErrorInfo بازرسی کنید تا بین خطاهای حد روزانه و حد در هر دقیقه تمایز قائل شوید و تعیین کنید که آیا باید موقتاً متوقف شود و با توقف مجدد تلاش کند، یا تا زمانی که سهمیه روزانه بازنشانی شود متوقف شود. برای جزئیات، خطاهای سهمیه و محدودیت نرخ را ببینید.

محدودیت‌های درخواست

در اینجا محدودیت‌های مربوط به درخواست‌های خاص آورده شده است:

  • IngestAudienceMembersRequest و RemoveAudienceMembersRequest:

    • ‫۱۰٬۰۰۰ منبع AudienceMember در فهرست audience_members

    • ‫۱۰ شناسه کاربر در UserData برای AudienceMember

    • ‫۱۰ منبع Destination در فهرست destinations

  • RemoveAllAudienceMembersRequest:

    • ‫۱۰ منبع Destination در فهرست destinations

  • IngestEventsRequest:

    • ‫۲٬۰۰۰ منبع Event در فهرست events

    • ‫۱۰ شناسه کاربر در UserData برای Event

    • ‫۱۰ منبع Destination در فهرست destinations