تم تطبيق نظام الحصص لواجهات برمجة التطبيقات Home APIs لضمان موثوقية الخدمة ومساعدة المطوّرين في إدارة حجم الزيارات بفعالية. تكون الحصص في الـ Home APIs على مستوى مشروع Google Cloud.
يبلغ الحدّ الأقصى لمعدّل الطلبات في واجهات برمجة التطبيقات Home APIs 30,000 طلب في الدقيقة لكل مشروع. ويشمل هذا الحدّ جميع الطلبات التي يتم إرسالها من خلال واجهات برمجة التطبيقات Home APIs.
تم تجاوز الحصة
عند تجاوز الحدّ الأقصى لمعدّل الطلبات في واجهات برمجة التطبيقات Home APIs، يتم عرض الخطأ
resourceExhaused
HomeError. وسيتم رفض الطلبات اللاحقة على الفور مع عرض الرسالة "تم تجاوز الحصة".
في حال تجاوز الحصة، يجب أن تعرض التطبيقات عملية إعادة محاولة متزايدة وأن تُعلم المستخدمين إذا تم تقييد الإجراءات مؤقتًا.
الرصد
استخدِم Google Cloud Console لتتبُّع الاستخدام في الوقت الفعلي و ضبط التنبيهات الاستباقية عندما تقترب من حصة واجهات برمجة التطبيقات Home APIs.
للاطّلاع على المقاييس الحالية، انتقِل إلى قسم المقاييس في خدمة Home API في المشروع Google Cloud المرتبط بتسجيل تطبيقك في Google Home Developer Console.
إعداد التنبيهات
ننصح الشركاء بإعداد تنبيهات عند تجاوز حدّ معيّن (مثل %80) من الحصة المخصّصة لك. يتوفّر في Google Cloud نطاق واسعة من التنبيهات التي يمكن ضبطها بشكل كبير.
عند إنشاء تنبيه للحصة، عليك استخدام المقاييس التالية ضمن حصة المستهلك > الحصة في أداة إنشاء السياسات.
- نسبة استخدام حصة التخصيص: serviceruntime.googleapis.com/quota/allocation/usage
- الحدّ الأقصى للحصة: serviceruntime.googleapis.com/quota/limit
على الشركاء أيضًا إعداد قنوات الإشعارات (مثل البريد الإلكتروني) لتلقّي تنبيهات الحصة.
اطّلِع على المَرجعين التاليَين لمعرفة المزيد عن التنبيهات والإشعارات و كيفية ضبطهما في Google Cloud:
طلب زيادة الحصة
إذا كان لتطبيقك زيارات مشروعة تتطلّب حدودًا أعلى من الحدّ الأقصى التلقائي لمعدّل الطلبات، يمكنك طلب زيادة الحصة.
للاطّلاع على الاستخدام والحدود، انتقِل إلى قسم الحصص والحدود القصوى للنظام في خدمة Home API في المشروع Google Cloud المرتبط بتسجيل تطبيقك في Developer Console.
لطلب زيادة الحصة، عدِّل حصة معيّنة. اطّلِع على طلب تعديل الحصة في مستندات Google Cloud للحصول على التعليمات.