حدود الاستخدام

بما أنّ Google Vault API هي خدمة مشترَكة، نطبّق حصصًا وقيودًا للتأكّد من استخدام جميع المستخدمين لها بشكل عادل ولحماية السلامة العامة لنظام Google Workspace.

الحدود القصوى للمنتجات

يجب ألا يكون لديك أكثر من 20 عملية تصدير قيد التقدّم على مستوى مؤسستك.

حصص طلبات واجهة برمجة التطبيقات

يُسمح لكل مؤسسة بإجراء 600 عملية قراءة مسألة قانونية في الدقيقة لجميع المشاريع والمستخدمين، بما في ذلك الطلبات من خلال Vault API وvault.google.com.

تسرد الجداول التالية حدود الطلبات لكل مشروع في الدقيقة:

قراءة الطلبات في الدقيقة لكل مشروع
تصدير المسألة القانونية وطلب البحث المحفوظ 120
تعليق 228
التشغيل لفترة طويلة 300
كتابة الطلبات في الدقيقة لكل مشروع
تصدير 20
تعليق 60
أذونات المسألة القانونية 30
Matter 60
طلب محفوظ 45
البحث (العدد) من الطلبات في الدقيقة لكل مشروع
أعداد عمليات البحث 20

استخدام الحصة حسب الطريقة

تعتمد الحصة المستخدمة في الطلب على طريقة الطلب. يسرد الجدول التالي استخدام الحصة لكل طريقة:

الطريقة تكاليف الحصة
matters.close
matters.create
matters.delete
matters.reopen
matters.update
matters.undelete 		قراءة مسألة قانونية واحدة
كتابة مسألة قانونية واحدة
matters.count عدد واحد
matters.get تمت قراءة مسألة قانونية واحدة
matters.list 10 قراءات للمسألة القانونية
matters.addPermissions
matters.removePermissions 		قراءة مسألة قانونية واحدة
كتابة مسألة قانونية واحدة
كتابة أذونات مسألة قانونية واحدة
matters.exports.create قراءة عملية تصدير واحدة
10 عمليات تصدير
matters.exports.delete كتابة عملية تصدير واحدة
matters.exports.get قراءة عملية تصدير واحدة
matters.exports.list عدد القراءات الذي تم تصديره: 5
matters.holds.addHeldAccounts
matters.holds.create
matters.holds.delete
matters.holds.removeHeldAccounts
matters.holds.update 		قراءة مسألة قانونية واحدة
كتابة مسألة قانونية واحدة
عملية تجميد بيانات واحدة
كتابة واحدة قيد الانتظار
matters.holds.list تمت قراءة مسألة قانونية واحدة
3 عمليات تجميد البيانات
matters.holds.accounts.create
matters.holds.accounts.delete
matters.holds.accounts.list 		قراءة مسألة قانونية واحدة
كتابة مسألة قانونية واحدة
عملية تجميد بيانات واحدة
كتابة واحدة قيد الانتظار
matters.savedQueries.create
matters.savedQueries.delete 		قراءة مسألة قانونية واحدة
كتابة مسألة قانونية واحدة
قراءة طلب محفوظ واحد
كتابة طلب محفوظ واحد
matters.savedQueries.get قراءة مسألة قانونية واحدة
تمت قراءة طلب محفوظ واحد
matters.savedQueries.list قراءة مسألة قانونية واحدة
قراءة 3 طلبات بحث محفوظة
operations.get تمت قراءة عملية واحدة طويلة المدى

حلّ أخطاء الحصص المستندة إلى الوقت

إذا تجاوزت حصة محدّدة في الدقيقة أو لكل مؤسسة، ستتلقّى عادةً الاستجابة 429: Too many requests لحالة HTTP.

بالنسبة إلى جميع الأخطاء المستندة إلى الوقت (بحد أقصى N طلب في X دقيقة)، ننصح بأن يلتقط الرمز الخاص بك الاستثناء ويستخدم تراجع أسّي مقتطع للتأكّد من أنّ الأجهزة لا تحمّل حِملًا زائدًا.

يعد التراجع الأسي استراتيجية قياسية لمعالجة الأخطاء لتطبيقات الشبكة. تعيد خوارزمية التراجع الأسي محاولة إعادة محاولة إرسال الطلبات باستخدام فترات انتظار متزايدة بين الطلبات، وصولاً إلى الحد الأقصى لوقت التراجع. إذا لم تنجح الطلبات إلى الآن، من المهم أن تزيد حالات التأخير بين الطلبات بمرور الوقت إلى أن يتم قبولها.

مثال على الخوارزمية

تعمل خوارزمية التراجع الأسي على إعادة محاولة تنفيذ الطلبات بشكل كبير، ما يزيد من وقت الانتظار بين عمليات إعادة المحاولة وصولاً إلى الحد الأقصى لوقت التراجع. مثال:

  1. يمكنك تقديم طلب إلى Google Vault API.
  2. إذا تعذّر إجراء الطلب، يُرجى الانتظار 1 + random_number_milliseconds ثم إعادة محاولة الطلب.
  3. إذا تعذّر إجراء الطلب، انتظر 2 + random_number_milliseconds ثم أعِد محاولة إجراء الطلب.
  4. إذا تعذّر إجراء الطلب، انتظر 4 + random_number_milliseconds ثم أعِد محاولة إجراء الطلب.
  5. وهكذا، حتى مرة واحدة (maximum_backoff).
  6. يمكنك مواصلة الانتظار وإعادة المحاولة لتصل إلى الحد الأقصى لعدد عمليات إعادة المحاولة، ولكن لا تزيد فترة الانتظار بين عمليات إعادة المحاولة.

المكان:

  • يبلغ وقت الانتظار min(((2^n)+random_number_milliseconds), maximum_backoff)، مع زيادة n بمقدار 1 لكل تكرار (طلب).
  • random_number_milliseconds هو عدد عشوائي بالمللي ثانية أقل من أو يساوي 1,000. ويساعد ذلك في تجنُّب الحالات التي تتم فيها مزامنة العديد من البرامج في بعض الحالات، ثم إعادة المحاولة في آنٍ واحد وإرسال الطلبات في موجات متزامنة. يُعاد احتساب قيمة random_number_milliseconds بعد كل طلب لإعادة المحاولة.
  • تتراوح مدّة "maximum_backoff" عادةً بين 32 أو 64 ثانية. وتعتمد القيمة المناسبة على حالة الاستخدام.

يمكن للعميل متابعة إعادة المحاولة بعد الوصول إلى الوقت maximum_backoff. لا تحتاج عمليات إعادة المحاولة بعد هذه المرحلة إلى مواصلة زيادة وقت التراجع. على سبيل المثال، إذا كان العميل يستخدم وقت maximum_backoff مدّته 64 ثانية، يمكن للعميل إعادة المحاولة كل 64 ثانية بعد الوصول إلى هذه القيمة. وفي مرحلة ما، يجب أن يُمنع العملاء من إعادة المحاولة إلى أجل غير مسمى.

يعتمد وقت الانتظار بين عمليات إعادة المحاولة وعدد هذه العمليات على حالة الاستخدام وحالة الشبكة.

طلب زيادة الحصة

بناءً على استخدام مشروعك للموارد، قد تريد طلب زيادة في الحصة. يُعتبَر طلبات البيانات من واجهة برمجة التطبيقات التي يجريها حساب الخدمة على أنّها تستخدم حسابًا واحدًا. لا يضمن التقدّم بطلب للحصول على حصة زائدة الموافقة. قد تستغرق زيادات الحصص الكبيرة وقتًا أطول للموافقة عليها.

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

لمزيد من المعلومات، اطّلِع على المراجع التالية:

السعر

تتوفّر جميع استخدامات Google Vault API بدون أي تكلفة إضافية لعملاء Google Workspace.