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