Zarządzanie limitami

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

Limit szybkości 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 interfejsów Home API zostanie przekroczony, zostanie zgłoszony błąd resourceExhaused. Kolejne żądania będą odrzucane od razu z komunikatem „Quota exceeded” (Przekroczono limit).HomeError

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

Monitorowanie

Użyj Google Cloudkonsoli, aby monitorować wykorzystanie w czasie rzeczywistym i skonfigurować proaktywne alerty, które będą Cię informować, gdy zbliżysz się do limitu interfejsów Home API.

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

Konfigurowanie alertów

Zalecamy, aby partnerzy skonfigurowali alerty informujące 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 w konstruktorze 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 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 uzasadniony ruch, który wymaga wyższych limitów niż domyślny limit częstotliwości, możesz poprosić o jego zwiększenie.

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

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