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

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

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

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

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

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

حدود حصة Picker API

تبلغ حصة الطلبات المسموح بها في Photos Picker API ‏100,000 طلب في الدقيقة لكل مشروع.

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

حدود حصص Library API

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

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

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

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

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

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

طلب حصة إضافية

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

مساحة تخزين الصور وجودتها

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