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