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

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

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

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

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

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

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

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

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

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

تجاوُز الحدود القصوى للحصة

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

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

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

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

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