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

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

لا يتم احتساب الإشعارات التي تسلّمها العنوان المحدّد عند فتح قناة إشعارات ضمن حدود الحصة. ومع ذلك، يتم احتساب المكالمات الواردة إلى الطرق changes.watch وchannels.stop وfiles.watch ضمن حصتك.

إذا تجاوزت حصة محدّدة، ستتلقّى استجابة لرمز حالة HTTP 403: User rate limit exceeded. قد تؤدي أيضًا عمليات التحقّق من الحد الأقصى لمعدّل الضريبة في خلفية Drive إلى إنشاء استجابة 429: Too many requests. وفي حالة حدوث ذلك، يجب استخدام خوارزمية الرقود الأسي وإعادة المحاولة لاحقًا. إذا بقيت ضمن حصص كل دقيقة أدناه، ليس هناك حد أقصى لعدد الطلبات التي يمكنك تقديمها في اليوم.

يوضّح الجدول التالي تفاصيل حدود طلبات البحث:

الحصص
طلبات البحث
لكل 100 ثانية 20,000
لكل 100 ثانية لكل مستخدم 20,000

معالجة الأخطاء في الحصة المستندة إلى الوقت

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

التسعير

يمكنك استخدام Google Drive API بدون أي تكلفة إضافية. لا يؤدي تجاوز حدود طلب الحصة إلى فرض رسوم إضافية، ولا يتم تحصيل رسوم من حسابك.

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

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

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

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