الحدود القصوى والحصص

اتّبِع هذا الدليل للتعرّف على الحدود والحصص عند استخدام Data Manager API.

حدود المشاريع

يجب أن يكون لديك مشروع على Google Cloud لاستخدام Data Manager API. يوفّر مشروع Google Cloud برنامج OAuth العميل وبيانات الاعتماد التي تستخدمها لمصادقة طلبات البيانات من واجهة برمجة التطبيقات.

تفرض Data Manager API حدودًا على عدد الطلبات في كل مشروع على Google Cloud، ويتم الفصل بينها حسب الخدمة ونوع العملية (قراءة البيانات مقابل تعديلها):

الخدمة العملية الطلبات في اليوم الطلبات في الدقيقة
IngestionService التغيير (الكتابة) 100,000 300
IngestionService قراءة 100,000 300
جميع الخدمات الأخرى مجتمعة التغيير (الكتابة) 50,000 300
جميع الخدمات الأخرى مجتمعة قراءة 50,000 300

يتم رفض الطلبات التي تتجاوز الحدود المسموح بها مع ظهور الخطأ RESOURCE_EXHAUSTED ورمز حالة HTTP‏ 429 Too Many Requests.

يمكنك التحكّم في تطبيقك والحدّ من معدّلات الاستخدام من خلال تقليل عدد الطلبات بشكل نشط وتقليل عدد طلبات البحث في الثانية من جهة العميل. يمكنك أيضًا إعداد تنبيهات بشأن الحصة ومراقبتها في Google Cloud Console لتلقّي إشعارات قبل أن يصل تطبيقك إلى حدوده.

أسماء الحصص

يتوافق كل حد مع اسم حد الحصة والمقياس في Google Cloud. عندما يتجاوز طلب ما أحد الحدود، تعرض Data Manager API اسم حدّ الحصة المسموح بها في حمولة التفاصيل العادية ErrorInfo ضمن metadata.quota_limit:

اسم الحدّ الأقصى للحصة الخدمة العملية نافذة الحدّ
IngestionMutateRequestsPerDayPerProject IngestionService تغيير اليوم 100,000
IngestionMutateRequestsPerMinutePerProject IngestionService تغيير دقيقة 300
IngestionReadRequestsPerDayPerProject IngestionService قراءة اليوم 100,000
IngestionReadRequestsPerMinutePerProject IngestionService قراءة دقيقة 300
ManagementMutateRequestsPerDayPerProject جميع الخدمات الأخرى تغيير اليوم 50,000
ManagementMutateRequestsPerMinutePerProject جميع الخدمات الأخرى تغيير دقيقة 300
ManagementReadRequestsPerDayPerProject جميع الخدمات الأخرى قراءة اليوم 50,000
ManagementReadRequestsPerMinutePerProject جميع الخدمات الأخرى قراءة دقيقة 300

افحص metadata.quota_limit في حمولة ErrorInfo للتمييز بين أخطاء الحدّ اليومي وأخطاء الحدّ المسموح به في الدقيقة الواحدة، وحدِّد ما إذا كان عليك إيقاف الطلبات مؤقتًا وإعادة المحاولة مع التراجع، أو إيقافها إلى أن تتم إعادة ضبط الحصة اليومية. لمعرفة التفاصيل، يُرجى الاطّلاع على أخطاء الحصة والحدّ الأقصى لعدد الطلبات.

حدود الطلبات

في ما يلي الحدود القصوى لطلبات معيّنة:

  • ‫IngestAudienceMembersRequest وRemoveAudienceMembersRequest:

    • ‫10,000 مورد AudienceMember في قائمة audience_members

    • ‫10 معرّفات مستخدمين في UserData لـ AudienceMember

    • ‫10 مراجع Destination في قائمة destinations

  • RemoveAllAudienceMembersRequest:

    • ‫10 مراجع Destination في قائمة destinations

  • IngestEventsRequest:

    • ‫2,000 مرجع Event في قائمة events

    • ‫10 معرّفات مستخدمين في UserData لـ Event

    • ‫10 مراجع Destination في قائمة destinations