Zarządzanie limitami

W interfejsach Home API został wdrożony system limitów, który zapewnia niezawodność usługi i pomaga deweloperom skutecznie zarządzać 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ń interfejsów 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 informować użytkowników o tymczasowym ograniczeniu działań.

Monitorowanie

Użyj Google Cloud Console, aby monitorować wykorzystanie w czasie rzeczywistym i skonfigurować proaktywne alerty na wypadek zbliżania 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.

Konfigurowanie alertów

Zalecamy, aby partnerzy skonfigurowali alerty na wypadek przekroczenia 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) do otrzymywania alertów 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.