تم تطبيق نظام الحصص لواجهات برمجة التطبيقات Home APIs لضمان موثوقية الخدمة ومساعدة المطوّرين في إدارة حجم الزيارات بفعالية. تكون الحصص في الـ Home APIs على مستوى مشروع Google Cloud.
الحدّ الأقصى لمعدّل الطلبات في واجهات برمجة التطبيقات Home APIs هو 30,000 طلب في الدقيقة لكل مشروع. يشمل هذا الحدّ جميع الطلبات التي يتم إرسالها من خلال واجهات برمجة التطبيقات Home APIs.
تم تجاوز الحصة
عند تجاوز الحدّ الأقصى لمعدّل الطلبات في واجهات برمجة التطبيقات Home APIs، يتم عرض
resourceExhaused
HomeException. وسيتم رفض الطلبات اللاحقة على الفور مع عرض الرسالة "تم تجاوز الحصة".
في حال تجاوز الحصة، يجب أن تعرض التطبيقات عملية إعادة محاولة متزايدة وأن تُعلم المستخدمين إذا تم تقييد الإجراءات مؤقتًا.
الرصد
استخدِم 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 للحصول على التعليمات.