تم تطبيق نظام الحصص لواجهات برمجة التطبيقات 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 للحصول على التعليمات.