مدیریت سهمیه

یک سیستم سهمیه‌بندی برای APIهای خانگی پیاده‌سازی شده است تا قابلیت اطمینان سرویس را تضمین کرده و به توسعه‌دهندگان در مدیریت مؤثر حجم ترافیک کمک کند. سهمیه‌بندی‌ها در APIهای خانگی در سطح پروژه Google Cloud هستند.

محدودیت سرعت برای APIهای خانگی 30،000 QPM (پرس‌وجو در دقیقه) برای هر پروژه است. این محدودیت شامل تمام پرس‌وجوهای ارسالی از طریق APIهای خانگی می‌شود.

سهمیه تجاوز کرد

وقتی از حد مجاز نرخ APIهای Home تجاوز شود، خطای resourceExhaused HomeError رخ می‌دهد. درخواست‌های بعدی بلافاصله با پیام "Quota exceeded" رد می‌شوند.

در صورتی که سهمیه از حد مجاز فراتر رود، برنامه‌ها باید یک عقب‌نشینی نمایی داشته باشند و در صورت محدود شدن موقت اقدامات، به کاربران اطلاع دهند.

نظارت

از کنسول Google Cloud برای نظارت بر میزان استفاده به صورت آنی و پیکربندی هشدارهای پیشگیرانه برای زمانی که به سهمیه APIهای خانگی نزدیک می‌شوید، استفاده کنید.

برای مشاهده معیارهای فعلی، به بخش معیارهای سرویس Home API در پروژه Google Cloud مرتبط با ثبت برنامه خود در Google Home Developer Console بروید.

تنظیم هشدارها

توصیه می‌کنیم شرکا برای عبور از یک آستانه (مانند ۸۰٪) از سهمیه اختصاص داده شده، هشدارهایی تنظیم کنند. پشتیبانی از هشدار در Google Cloud بسیار گسترده و بسیار قابل تنظیم است.

هنگام ایجاد هشدار برای سهمیه، باید از معیارهای زیر در بخش سهمیه مصرف‌کننده > سهمیه در سازنده سیاست استفاده کنید.

  • میزان استفاده از سهمیه تخصیص — serviceruntime.googleapis.com/quota/allocation/usage
  • محدودیت سهمیه — serviceruntime.googleapis.com/quota/limit

شرکا همچنین باید کانال‌های اعلان (مانند ایمیل) را برای دریافت هشدارهای سهمیه تنظیم کنند.

برای کسب اطلاعات بیشتر در مورد هشدارها و اعلان‌ها و نحوه پیکربندی آنها در Google Cloud ، به منابع زیر مراجعه کنید:

درخواست افزایش سهمیه

اگر برنامه شما ترافیک قانونی دارد که به محدودیت‌های بالاتری نسبت به محدودیت نرخ پیش‌فرض نیاز دارد، می‌توانید درخواست افزایش دهید.

برای مشاهده میزان استفاده و محدودیت‌ها، به بخش سهمیه‌ها و محدودیت‌های سیستم (Quotas & System Limits) در سرویس Home API در پروژه Google Cloud مرتبط با ثبت برنامه خود در Developer Console بروید.

برای درخواست افزایش، سهمیه‌ی خاصی را ویرایش کنید. برای دستورالعمل‌ها به «درخواست تنظیم سهمیه» در مستندات Google Cloud مراجعه کنید.