تعمل الحدود والحصص على حماية بنية Google الأساسية من عملية تلقائية تستخدم Reports API بطريقة غير ملائمة. وقد تنتج الطلبات المفرطة من واجهة برمجة التطبيقات عن خطأ إملائي غير مؤذٍ، أو قد تنتج عن نظام مصمّم بشكل غير فعال يجعل طلبات البيانات من واجهة برمجة التطبيقات غير ضرورية. وبغض النظر عن السبب، من الضروري حظر الزيارات من مصدر معيَّن بمجرد وصوله إلى مستوى معيَّن لكي نحافظ على سلامة نظام Google Workspace بشكل عام. ويضمن هذا الإجراء عدم إمكانية تأثير إجراءات أحد مطوّري البرامج سلبًا في المنتدى الأكبر.
في حال فشل طلب واجهة برمجة التطبيقات، وهو أمر مستبعد، ستتلقى استجابة رمز حالة HTTP. يحتوي رمز الحالة 403 على معلومات خطأ حول الإدخال غير الصحيح، ورمز حالة HTTP 503 يتضمن معلومات خطأ تشير إلى حصص واجهة برمجة التطبيقات التي تم تجاوزها. تتيح هذه الاستجابات للتطبيق المخصّص رصد هذه الأخطاء واتّخاذ الإجراء المناسب.
إذا كانت هناك حاجة إلى إكمال طلباتك خلال فترة زمنية محددة، أرسِل طلباتك بالتوازي أو استخدِم سلاسل محادثات متعددة في تطبيق Java أو C#. من أمثلة الطلبات الموازية طلب دفعات صغيرة من رسائل البريد الإلكتروني من مستخدمين مختلفين بدلاً من إضافة الكثير من رسائل البريد الإلكتروني أو إزالتها من مستخدم واحد في وقت واحد. بالنسبة إلى سلاسل المحادثات، جرِّب البدء بـ 10 سلاسل محادثات، مع سلسلة محادثات واحدة لكل عنوان بريد إلكتروني للمستخدم. يُرجى العلم أنّ اقتراح سلسلة المحادثات ينطوي على حلول وسط، وهو ليس مفيدًا في جميع حالات واجهات برمجة التطبيقات. وفي حال كان عدد الطلبات مرتفعًا جدًا، ستحدث أخطاء في الحصة.
بالنسبة إلى جميع الأخطاء التي تستند إلى الوقت (الحد الأقصى N من الأشياء لمدة N ثانية لكل سلسلة محادثات)، وخاصةً أخطاء رمز الحالة 503، ننصح بالرمز الذي يتضمّن استثناءً، وباستخدام خوارزمية التراجع الأسّي، يجب الانتظار قليلاً قبل إعادة محاولة الاتصال الذي تعذّر إكماله. من أمثلة Reports API لسلسلة محادثات واحدة، ما عليك سوى الانتظار لمدة 5 ثوانٍ ثم إعادة محاولة إجراء الاتصال الذي تعذّر تنفيذه. إذا نجح الطلب، كرِّر هذا النمط لسلاسل المحادثات الأخرى. وإذا لم ينجح الطلب الثاني، فينبغي لتطبيقك تقليل معدل تكرار الطلب حتى يتم الاستدعاء بنجاح. على سبيل المثال، يمكنك زيادة التأخير الأولي الذي يبلغ 5 ثوانٍ إلى 10 ثوانٍ، ثم أعِد محاولة إجراء المكالمة التي تعذّر إجراؤها مرة أخرى. كما يمكنك تحديد حد إعادة المحاولة. على سبيل المثال، يمكنك إعادة محاولة تقديم طلب من 5 إلى 7 مرات بأوقات تأخير مختلفة قبل أن يعرض التطبيق خطأ للمستخدم.
| فئات الحد الأقصى المسموح به من واجهة برمجة التطبيقات | الحدود القصوى المسموح بها |
|---|---|
| إعداد تقارير عن معدّلات QPS وQPD | تفرض واجهة برمجة التطبيقات قيودًا على عدد الطلبات الخاصة بمشروعك على Google Cloud.
القيمة التلقائية التي تم ضبطها في Google Cloud Console هي 2,400 طلب بحث في الدقيقة لكل مستخدم لكل مشروع على Google Cloud.
يمكنك زيادة هذا الحد من صفحة حصص واجهة برمجة التطبيقات لـ SDK للمشرف في مشروعك على Google Cloud.
وإذا تم تجاوز هذه الحدود، يعرض الخادم رمز الحالة HTTP 503. يمكنك استخدام خوارزمية التراجع الأسي عند إعادة محاولة تنفيذ طلباتك. |
| فئات حصص واجهة برمجة التطبيقات | الحصص |
| الحد الأقصى للنتائج | يتراوح عدد السجلات المعروضة في كل صفحة من استجابة واجهة برمجة التطبيقات من حدث واحد إلى 1000 حدث. القيمة التلقائية هي 1000 سجلّ. |
| أنواع أخرى من الحدود | القيود والإرشادات |
|---|---|
| تنسيق البيانات، تلقائي | تنسيق البيانات التلقائي هو JSON. تدعم واجهة برمجة التطبيقات أيضًا تنسيق Atom. |
| الطلبات غير المصرّح بها | ولا تسمح Google بالطلبات غير المصرّح بها لواجهة برمجة التطبيقات. يُعتبَر الطلب غير مُصرَّح به في حال عدم تقديم رمز مميّز للتفويض. وللحصول على مزيد من المعلومات، يُرجى الاطّلاع على قسم السماح بالطلبات. |
| رسائل التحذير |
|