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

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

يتم تحديد الحدود من حيث وحدات الحصة، وهي وحدة قياس مجرّدة تمثّل استخدام موارد Google Drive.

حصص Drive API

يتم فرض ثلاثة أنواع من الحصص:

• لكل دقيقة لكل مشروع: هذا هو عدد وحدات الحصة التي يمكن أن يستخدمها مشروعك على Google Cloud في دقيقة واحدة.

• في الدقيقة الواحدة لكل مستخدم ولكل مشروع: هذا هو عدد وحدات الحصة التي يمكن لأي مستخدم معيّن استخدامها في مشروعك على السحابة الإلكترونية. يهدف هذا الحد إلى مساعدتك في ضمان توزيع الاستخدام بشكل عادل بين المستخدمين.

• في اليوم لكل مشروع: يحدّد هذا الخيار الحد الأقصى لعدد البايتات التي يمكن لمشروعك على Google Cloud إرسالها خلال فترة 24 ساعة قبل تطبيق الرسوم.

يوضّح الجدول التالي هذه الحدود:

نوع الحدّ الأقصى للاستخدام	الحدّ
في الدقيقة لكل مشروع	مليون وحدة حصة
في الدقيقة الواحدة لكل مستخدم ولكل مشروع	‫325,000 وحدة حصة
لكل مشروع في اليوم	1 تيرابايت

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

حدّ الفوترة اليومي

يحدّد هذا الحد لكل مشروع في اليوم الحد الأقصى لعدد وحدات الحصة التي يمكن أن يستخدمها مشروعك على Google Cloud خلال فترة 24 ساعة قبل تطبيق الرسوم.

لا يؤدي الاستخدام ضمن هذا الحد إلى تحمّل رسوم إضافية، ولا يتم تحصيل أي رسوم من حسابك على Google Cloud. ستتم مشاركة تفاصيل الفوترة الكاملة في وقت لاحق من عام 2026 مع إرسال إشعار قبل 90 يومًا على الأقل من سريان أي تغييرات.

ولا يمكنك طلب زيادة الحدّ اليومي الأقصى.

يوضّح الجدول التالي الحدّ الأقصى:

نوع الحدّ الأدنى	الحدّ
لكل مشروع في اليوم	‫400,000,000 وحدة حصة

لمزيد من المعلومات، يُرجى الاطّلاع على نموذج Google Workspace الموحّد لأدوات الوكلاء وواجهات برمجة التطبيقات.

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

يختلف عدد وحدات الحصة المستخدَمة لكل طلب حسب الطريقة التي تم استدعاؤها. يوضّح الجدول التالي استخدام وحدات الحصة لكل طريقة:

الإجراء	وحدات الحصة
قراءة العناصر، مثل files.get	5
عناصر القائمة، مثل files.list	100
تنزيل عناصر، مثل files.download	200
تعديل العناصر، مثل files.update	50
إجراءات أخرى، مثل files.generateIds	5

قيود إضافية

يتم فرض القيود التالية عند استخدام Drive API:

• يمكن لمستخدمي Google Workspace تحميل 750 غيغابايت فقط في اليوم بين "ملفاتي" وجميع مساحات Drive المشتركة، وينطبق هذا الحدّ أيضًا على النسخ.

• لا يمكن للمستخدمين الذين يصلون إلى الحد الأقصى البالغ 750 غيغابايت أو يحمِّلون ملفًا يتجاوز حجمه 750 غيغابايت تحميل المزيد من الملفات أو نسخها حتى مرور 24 ساعة.

• الحد الأقصى لحجم الملف الذي يمكن للمستخدمين تحميله هو 5 تيرابايت، ولا تكتمل عملية التحميل سوى للملف الأول الذي تجاوز به الحد. الحد الأقصى لحجم الملف الذي يمكن للمستخدمين نسخه هو 750 غيغابايت.

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

• ما دمت تلتزم بالحصة المحدّدة لكل دقيقة، ليس هناك حدّ لعدد الطلبات التي يمكنك إرسالها في اليوم.

• وفقًا لنوع حسابك على Google Workspace، هناك حدود إضافية لمساحة التخزين في Drive.

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

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

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

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

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

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

where:

• يبلغ وقت الانتظار 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 Drive API بدون أي تكلفة إضافية. من المقرر أن يؤدي تجاوز حدود طلبات الحصة إلى فرض رسوم على حساب الفوترة في Google Cloud في وقت لاحق من عام 2026. لمزيد من المعلومات، يُرجى الاطّلاع على نموذج Google Workspace الموحّد لأدوات وواجهات برمجة التطبيقات الخاصة بالوكلاء.

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

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

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

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

• لمحة عن تعديلات الحصة
• الاطّلاع على نسبة استهلاكك من الحصة وحدودها
• طلب زيادة الحدّ الأقصى للحصة

حصص خادم MCP في Drive

يستخدم خادم "بروتوكول سياق النموذج" (MCP) في Drive مقياسًا لتخصيص تكلفة طلب البحث. توضّح الجداول التالية تفاصيل تكلفة طلب البحث لكل طريقة من طرق خادم MCP في Drive حسب القسم:

حصة بروتوكول سياق النموذج (MCP) في Drive

يتم فرض نوعَين من الحصص:

• لكل دقيقة لكل مشروع: هذه هي تكلفة طلب البحث لمشروعك على Google Cloud لمدة دقيقة واحدة.

• في الدقيقة الواحدة لكل مستخدم ولكل مشروع: هذه هي تكلفة طلب البحث في مشروعك على السحابة الإلكترونية على Google Cloud لمدة دقيقة واحدة يمكن لأي مستخدم معيّن استخدامها.

يوضّح الجدول التالي تفاصيل هذه الحصص:

نوع الحدّ الأقصى للاستخدام	تكلفة طلب البحث
في الدقيقة لكل مشروع	325,000
في الدقيقة الواحدة لكل مستخدم ولكل مشروع	1,000,000

حصص مجموعة أدوات بروتوكول سياق النموذج (MCP) في Drive

يوضّح الجدول التالي تكلفة طلب البحث لكل drivemcp.googleapis.comمجموعة أدوات:

نقطة نهاية	الأداة	تكلفة طلب البحث
/mcp/v1	copy_file	50
	create_file	50
	download_file_content	200
	get_file_metadata	5
	get_file_permissions	5
	list_recent_files	100
	read_file_content	200
	search_files	100

لمزيد من المعلومات، يُرجى الاطّلاع على مرجع واجهة برمجة التطبيقات MCP في Drive.

مواضيع ذات صلة

• تحسين الأداء
• حدود الملفات والمجلدات
• حدود الملفات والمجلدات في مساحات التخزين السحابي المشتركة