سهمیه‌ها و محدودیت‌های «خانه هوشمند»

‫Google Home تخصیص و استفاده از منابع را محدود می‌کند و سهمیه‌های مناسب را براساس هر پروژه اعمال می‌کند. خط‌مشی‌های خاص بسته به دردسترس بودن منبع، نمایه کاربر، سابقه استفاده از سرویس، و عوامل دیگر متفاوت است و ممکن است بدون اطلاع قبلی تغییر کند.

محدودیت‌های HomeGraph API

این بخش فهرست محدودیت‌های نرخ برای Google Home Graph API را ارائه می‌دهد. این محدودیت‌ها هم برای REST و هم برای RPC API اعمال می‌شود.

‫Google حد پیش‌فرض ۶٬۰۰۰ درخواست در هر ۶۰ ثانیه را برای مجموعه پُرسمان، همگام‌سازی، حذف، Report State، و فراخوانی‌های ناهمگام‌سازی درخواست API، براساس هر Cloud-to-cloud ادغام اعمال می‌کند.

برای درخواست افزایش سهمیه، با ha-certification@google.com تماس بگیرید و اطلاعات زیر را ارائه دهید:

  • موضوع ایمیل: درخواست افزایش سهمیه ReportState API
  • محتوای ایمیل:
    • شناسه پروژه
    • نام شرکت شما
    • سهمیه کنونی
    • دلیل اینکه می‌خواهید سهمیه خود را افزایش دهید
سهمیه حد می‌تواند افزایش یابد
RequestSync (حالت هم‌زمان) حداکثر ۱ درخواست هم‌زمان در هر agentUserId. نه
RequestSync (حالت غیرهمگام) محدودیت پیش‌فرض ۶٬۰۰۰ درخواست در ۶۰ ثانیه برای هر یکپارچگی Cloud-to-cloud. بله
پُرسمان محدودیت پیش‌فرض ۶٬۰۰۰ درخواست در ۶۰ ثانیه برای هر یکپارچگی Cloud-to-cloud. بله
همگام‌سازی محدودیت پیش‌فرض ۶٬۰۰۰ درخواست در ۶۰ ثانیه برای هر یکپارچگی Cloud-to-cloud. بله
حذف محدودیت پیش‌فرض ۶٬۰۰۰ درخواست در ۶۰ ثانیه برای هر یکپارچگی Cloud-to-cloud. بله
ReportStateAndNotification محدودیت پیش‌فرض ۶٬۰۰۰ درخواست در ۶۰ ثانیه برای هر یکپارچگی Cloud-to-cloud. بله

اشکال‌زدایی کردن مشکلات سهمیه

اگر یکپارچه‌سازی شما با محدودیت نرخ مواجه شد، از دستورالعمل‌های زیر برای تشخیص و رفع مشکلات سهمیه استفاده کنید:

  1. ‫Google تماس‌های API را که از سهمیه شما فراتر می‌روند محدود می‌کند. این امر با ایجاد عدم تطابق وضعیت، تأثیر منفی بر یکپارچه‌سازی شما می‌گذارد. برای مثال، اگر درخواستی ReportStateAndNotification به‌دلیل محدودیت نرخ رد شود، وضعیت دستگاه فیزیکی همگام‌سازی نمی‌شود و Google Home app (GHA) اطلاعات قدیمی را نشان می‌دهد.

  2. اگر RequestSync API اصلی است که با خطا مواجه شده است، بررسی کنید که سرویس شما سعی نمی‌کند بیش‌از یک تماس هم‌زمان در هر agentUserId برقرار کند.

  3. رشد ترافیک خود را در طول زمان بررسی کنید. اگر این رشد با افزایش تعداد دستگاه‌ها، راه‌اندازی نوع جدیدی از دستگاه، یا راه‌اندازی مورد انتظار دیگری هم‌زمان است، درخواست افزایش سهمیه کنید. اگر این افزایش غیرمنتظره است، یکپارچه‌سازی خود را بررسی کنید تا مشخص شود آیا تغییر غیرمنتظره‌ای باعث ارسال ترافیک بیشتر به Home Graph API شده است یا خیر.