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