سیستم سهمیه‌ای برای «میاناهای برنامه‌سازی کاربردی خانه» پیاده‌سازی شده است تا از قابلیت اطمینان سرویس اطمینان حاصل شود و به توسعه‌دهندگان کمک کند حجم ترافیک را به‌طور مؤثر مدیریت کنند. سهمیه‌ها در میاناهای برنامه‌سازی کاربردی «خانه» در سطح پروژه Google Cloud هستند.
حد نرخ برای «میاناهای برنامه‌سازی کاربردی خانه» ۳۰٬۰۰۰ پُرسمان در دقیقه برای هر پروژه است. این حد شامل همه پُرسمان‌های ارسال‌شده ازطریق Home APIs می‌شود.
از حد سهمیه فراتر رفته‌اید
وقتی از حد مجاز نرخ «میاناهای برنامه‌سازی کاربردی خانه» فراتر بروید،
resourceExhaused
HomeException
پرتاب می‌شود. درخواست‌های بعدی بلافاصله با پیام «سهمیه فراتر رفته است» رد خواهد شد.
درصورتی‌که از سهمیه فراتر رفتید، برنامه‌ها باید از پس‌گیری نمایی استفاده کنند و اگر کنش‌ها موقتاً محدود شدند به کاربران اطلاع دهند.
پایش کردن
از «کنسول Google Cloud» برای نظارت بر استفاده در زمان واقعی و پیکربندی هشدارهای پیش‌کنشی برای زمانی که به سهمیه «میاناهای برنامه‌سازی کاربردی خانه» نزدیک می‌شوید استفاده کنید.
برای مشاهده سنجه‌های فعلی، به بخش سنجه‌ها در سرویس Home API در پروژه Google Cloud منسوب به ثبت برنامه در Google Home Developer Console بروید.
راه‌اندازی هشدارها
توصیه می‌کنیم که شرکا برای عبور از آستانه (مانند ۸۰٪) سهمیه اختصاص‌یافته خود هشدار تنظیم کنند. پشتیبانی از هشدار در Google Cloud بسیار گسترده و بسیار قابل‌پیکربندی است.
هنگام ایجاد هشدار برای سهمیه، می‌خواهید از سنجه‌های زیر در سهمیه مصرف‌کننده > سهمیه در سازنده خط‌مشی استفاده کنید.
- استفاده از سهمیه تخصیص — serviceruntime.googleapis.com/quota/allocation/usage
- حد سهمیه — serviceruntime.googleapis.com/quota/limit
شرکا باید کانال‌های اعلان (مانند ایمیل) را نیز برای دریافت هشدارهای سهمیه تنظیم کنند.
برای کسب اطلاعات بیشتر درباره هشدارها و اعلان‌ها و نحوه پیکربندی آن‌ها در Google Cloud، منابع زیر را ببینید:
درخواست افزایش سهمیه
اگر برنامه شما ترافیک قانونی دارد که به محدودیت‌های بالاتر از محدودیت نرخ پیش‌فرض نیاز دارد، می‌توانید درخواست افزایش دهید.
برای مشاهده میزان استفاده و محدودیت‌ها، به بخش سهمیه‌ها و حدود سیستم در سرویس Home API در پروژه Google Cloud منسوب به ثبت برنامه در Developer Console بروید.
برای درخواست افزایش، سهمیه خاصی را ویرایش کنید. برای دستورالعمل‌ها، درخواست اصلاح سهمیه در اسناد Google Cloud را ببینید.