W przypadku interfejsów Home API wdrożyliśmy system limitów, aby zapewnić niezawodność usługi i pomóc deweloperom w efektywnym zarządzaniu ruchem. Limity w interfejsach Home API są ustawiane na Google Cloudpoziomie 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 częstotliwości żądań interfejsów Home API zostanie przekroczony, zwracany jest błąd
resourceExhaused
HomeError. 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, gdy działania są tymczasowo ograniczone.
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 wGoogle Cloud projekcie powiązanym z rejestracją aplikacji w Google 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:
- Tworzenie zasad tworzenia alertów dotyczących progów wskaźników
- Tworzenie kanałów powiadomień i zarządzanie nimi
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 wusłudze Home API w Google Cloud projekcie powiązanym z rejestracją aplikacji w Developer Console.
Aby poprosić o zwiększenie limitu, zmodyfikuj konkretny limit. Instrukcje znajdziesz w dokumentacji dotyczącej Google Cloud.