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

يتم احتساب جميع الطلبات المُرسَلة إلى واجهة برمجة تطبيقات مكتبة "صور Google" ضمن مساحة تخزين معيّنة. نضع هذه الحدود لحماية النظام ومستخدميه.

يتطلب الوصول إلى واجهة برمجة التطبيقات استخدام بيانات اعتماد عميل OAuth من مشروع Google Developers. يجب تفعيل واجهة برمجة التطبيقات Library API لهذا المشروع كما هو موضَّح في البدء.

للحصول على مزيد من المعلومات حول الاستخدام السليم لواجهة برمجة التطبيقات هذه، يمكنك الاطّلاع على سياسة الاستخدام المقبول.

حدود الحصص العامة

إنّ الحدّ الأقصى للحصة المخصّصة للطلبات التي يتم إرسالها إلى Library API هو 10,000 طلب لكل مشروع في اليوم. ويشمل ذلك جميع طلبات واجهة برمجة التطبيقات، مثل التحميل وإدراج الوسائط وتطبيق الفلاتر، بدون الوصول إلى وحدات البايت الخاصة بالوسائط من عنوان URL أساسي.

إنّ الحدّ الأقصى للحصة المخصّصة لطلبات الوصول إلى وحدات بايت الوسائط (من خلال تحميل صورة أو فيديو من عنوان URL أساسي) هو 75,000 طلب لكل مشروع في اليوم.

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

جارٍ التحقّق من استخدام الحصة

للاطّلاع على المقدار الذي استخدمته من حصتك المتاحة، وعرض أو تغيير حدود الاستخدام لمشروعك، انتقِل إلى صفحة الحصص في وحدة تحكُّم Google API، واختَر Photos Library API.

تجاوز حدود الحصة

في حال تجاوز حصة الطلبات لواجهة برمجة التطبيقات Library API، تعرِض واجهة برمجة التطبيقات رمز الخطأ 429 ورسالة تفيد بأنّ المشروع قد تجاوز الحصة المحدَّدة. لمزيد من المعلومات، راجِع بنود الخدمة.

جارٍ طلب حصة إضافية

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

تخزين الصور وجودتها

يتم تخزين جميع ملفات الوسائط التي تم تحميلها إلى "صور Google" باستخدام واجهة برمجة التطبيقات بدقة كاملة بالجودة الأصلية. يتم احتسابها ضمن مساحة تخزين المستخدم.