Zarządzanie limitami

W przypadku interfejsów Home API wdrożono system limitów, aby zapewnić niezawodność usługi i pomóc deweloperom w skutecznym zarządzaniu natężeniem ruchu. Limity w interfejsach Home API są ustawiane na poziomie projektu Google Cloud.

Limit żądań w przypadku interfejsów Home API wynosi 30 tys. zapytań na minutę na projekt. Ten limit obejmuje wszystkie zapytania wysyłane przez interfejsy Home API.

Przekroczono limit miejsca

Gdy limit żądań interfejsów API Google Home zostanie przekroczony, zostanie wygenerowany błąd resourceExhaused HomeException. Kolejne żądania będą natychmiast odrzucane z komunikatem „Przekroczono limit”.

W przypadku przekroczenia limitu aplikacje powinny stosować wzrastający czas do ponowienia i powiadamiać użytkowników o tymczasowym ograniczeniu działań.

Monitorowanie

Używaj konsoli Google Cloud, aby monitorować wykorzystanie w czasie rzeczywistym i skonfigurować proaktywne alerty, które będą wysyłane, gdy zbliżysz się do limitu interfejsów Home API.

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.

Skonfiguruj alerty

Zalecamy, aby partnerzy skonfigurowali alerty o przekroczeniu progu (np. 80%) przydzielonego limitu. Obsługa alertów w Google Cloud jest bardzo rozbudowana i wysoce konfigurowalna.

Podczas tworzenia alertu dotyczącego limitu użyj w kreatorze zasad tych danych w sekcji Limit klienta > 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 dotyczące limitów.

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 generuje prawidłowy ruch, który wymaga wyższych limitów niż domyślny limit liczby żądań, możesz poprosić o zwiększenie limitu.

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, zmodyfikuj konkretny limit. Instrukcje znajdziesz w artykule Prośba o dostosowanie limitu w dokumentacji Google Cloud.