Zarządzanie limitami

Wdrożyliśmy system limitów dla interfejsów Home API, aby zapewnić niezawodność usługi i pomóc deweloperom w skutecznym zarządzaniu ruchem. Limity w interfejsach Home API są ustawiane na poziomie Google Cloud projektu.

Limit częstotliwości żądań w interfejsach Home API wynosi 30 tys. zapytań na minutę na projekt. Ten limit obejmuje wszystkie zapytania wysyłane przez interfejsy Home API.

Przekroczono limit

Gdy limit częstotliwości żądań w interfejsach Home API zostanie przekroczony, zostanie zgłoszony wyjątek resourceExhaused HomeException. Kolejne żądania będą natychmiast odrzucane z komunikatem „Przekroczono limit”.

Jeśli limit zostanie przekroczony, aplikacje powinny stosować wzrastający czas do ponowienia i powiadamiać użytkowników o tymczasowym ograniczeniu działań.

Monitorowanie

Aby monitorować wykorzystanie w czasie rzeczywistym i skonfigurować proaktywne alerty, gdy zbliżasz się do limitu interfejsów Home API, użyj Google Cloud Console.

Aby wyświetlić bieżące dane, otwórz sekcję Dane usługi Home API w projekcie Google Cloud powiązanym z rejestracją aplikacji w Google Home Developer Console.

Konfigurowanie alertów

Zalecamy, aby partnerzy skonfigurowali alerty, które będą się pojawiać po przekroczeniu określonego progu (np. 80%) przydzielonego limitu. Obsługa alertów w Google Cloud jest bardzo rozbudowana i wysoce konfigurowalna.

Podczas tworzenia alertu dotyczącego limitu w kreatorze zasad użyj tych danych w sekcji Limit konsumencki > Limit.

  • Wykorzystanie limitu przydziału – serviceruntime.googleapis.com/quota/allocation/usage
  • Limit przydziału – serviceruntime.googleapis.com/quota/limit

Partnerzy powinni też skonfigurować kanały powiadomień (np. e-mail), aby otrzymywać alerty o limitach.

Więcej informacji o alertach i powiadomieniach oraz o tym, jak je skonfigurować w Google Cloud, znajdziesz w tych materiałach:

Poproś o zwiększenie limitu

Jeśli Twoja aplikacja ma uzasadniony ruch, który wymaga wyższych limitów niż domyślny limit częstotliwości żądań, możesz poprosić o jego zwiększenie.

Aby wyświetlić wykorzystanie i limity, otwórz sekcję Limity przydziału i limity systemu usługi Home API w projekcie Google Cloud powiązanym z rejestracją aplikacji w Developer Console.

Aby poprosić o zwiększenie limitu, edytuj konkretny limit. Instrukcje znajdziesz w dokumentacji w artykule Prośba o dostosowanie limitu Google Cloud.