Limity żądań API

W tym dokumencie opisujemy ograniczenia i limity związane z żądaniami interfejsów API zarządzania i interfejsów API do raportowania.

Z Google Analytics korzystają miliony witryn. Stosujemy limity żądań do interfejsów API, aby chronić system przed otrzymaniem większej ilości danych, niż jest w stanie obsłużyć, i zapewnić sprawiedliwy rozkład zasobów systemowych. Limity mogą ulec zmianie.

W tym filmie omawiamy sprawdzone metody zarządzania limitami żądań w interfejsie Google Analytics API.

Ogólne limity

W przypadku interfejsów Management API, Core Reporting API w wersji 3, MCF Reporting API, Metadata API, User Deletion API i Real Time Reporting API obowiązują te limity:

  • 50 tys. żądań na projekt dziennie, które można zwiększyć.
  • 10 zapytań na sekundę na adres IP.
    • W konsoli interfejsów API obowiązuje podobny limit nazywany żądaniami na 100 sekund na użytkownika. Domyślnie ustawiona jest wartość 100 żądań na 100 sekund na użytkownika, ale można ją zmienić na 1000. Liczba żądań wysyłanych do interfejsu API jest ograniczona do maksymalnie 10 żądań na sekundę na użytkownika.
    • Jeśli Twoja aplikacja wysyła wszystkie żądania do interfejsu API z jednego adresu IP (tj. w imieniu użytkowników), używaj w każdym żądaniu parametru userIP lub quotaUser, aby uzyskać pełny limit zapytań na sekundę dla każdego użytkownika. Szczegółowe informacje znajdziesz w podsumowaniu standardowych parametrów zapytania.

Reporting APIs

Te limity dotyczą wszystkich interfejsów API do raportowania, w tym Core Reporting API v3, Analytics Reporting API w wersji 4, Real Time API w wersji 3 oraz interfejsu Multi-channel Funnel API w wersji 3:

  • 10 000 żądań na widok (profil) dziennie (nie można go zwiększyć)
  • 10 równoczesnych żądań na widok (profil) (nie można zwiększyć)

Raportowanie błędów żądań do interfejsów API

Jeśli żądanie wysyłane do interfejsu API do raportowania nie powiedzie się z powodu błędu serwera, otrzymasz kod odpowiedzi 500 lub 503. Możesz przesłać prośbę ponownie. Jeśli jednak Twoja prośba będzie się powtarzała, nie przesyłaj więcej niż raz. Google Analytics zezwala na:

  • 10 nieudanych żądań związanych z błędami serwera na projekt na widok (profil) na godzinę
  • 50 nieudanych żądań z błędami serwera na projekt na widok (profil) dziennie

Jeśli liczba nieudanych żądań przekroczy te limity, zobaczysz ten błąd:

Quota Error: The number of recent reporting API requests failing by server error is too high.
You are temporarily blocked from the reporting API for at least an hour.
Please send fewer server errors in the future to avoid being blocked.

Aby zmniejszyć ryzyko wystąpienia błędów serwera żądań, uprość żądanie, ograniczając zakres dat, zmniejszając liczbę wymiarów w żądaniu lub liczbę danych w żądaniu.

Nie przesyłaj stale odrzuconego żądania. Zamiast tego zaimplementuj wykładniczy czas ponowienia, aby przesłać go ponownie.

Limity liczby błędów serwera są egzekwowane w cyklicznych okresach dla każdego z godzinowych i dziennych limitów liczby błędów. Po upływie godziny od pierwszego błędu serwera w projekcie i wyświetlenia pierwszego błędu serwera limit jest resetowany. Jeśli w ciągu godziny para projektu i widoku wyśle 10 błędów serwera, para projektu i widoku zostanie zablokowana w interfejsie API aż do godziny, w której upłynie pierwszy błąd serwera.

Jeśli na przykład w ciągu ostatnich 24 godzin para projektu i widoku nie wysłała błędu serwera, ten projekt i widok będą wykorzystywać 0 z 50 limitów. Załóżmy, że ten projekt i widok zgłaszają teraz błąd serwera o 6:12. Jeśli ten projekt i widok wyślą 49 dodatkowych błędów serwera przed 6:12 następnego dnia, ten projekt i widok będą zablokowane do godziny 6:12 następnego dnia. O 6:12 następnego dnia limit odsetka błędów serwera dla tego projektu i widoku zostanie całkowicie zresetowany.

Przekroczenie limitu

Jeśli zostanie przekroczony limit żądań do interfejsu Google Analytics API, interfejs ten zwróci kod błędu 403 lub 429 i komunikat, że limit został przekroczony na koncie. Więcej informacji znajdziesz w Warunkach korzystania z usługi.

Wysyłam prośbę o dodatkowy limit

Możesz poprosić tylko o zwiększenie:

Aby wyświetlić lub zmienić limity wykorzystania w projekcie albo poprosić o zwiększenie limitu, wykonaj te czynności:

  1. Jeśli nie masz jeszcze konta rozliczeniowego na potrzeby swojego projektu, utwórz je.
  2. Otwórz stronę Włączone interfejsy API biblioteki interfejsów API w konsoli API i wybierz interfejs API z listy.
  3. Aby wyświetlić i zmienić ustawienia związane z limitami, wybierz Limity. Aby wyświetlić statystyki użytkowania, wybierz Użycie.

Aby poprosić o zwiększenie maksymalnego limitu, skorzystaj z formularza prośby o zwiększenie limitu w interfejsie Analytics API. Przed przesłaniem prośby zapoznaj się z informacjami i postępuj zgodnie z instrukcjami podanymi w formularzu prośby o limit. W przypadku interfejsu Reporting API w wersji 4 nazwa interfejsu API w Konsoli Google API to Google Analytics Reporting API. Wszystkie inne interfejsy API w wersji 3 (np. Interfejs Management API v3, Core Reporting API 3, Real Time Reporting API v3 czy interfejs User Deletion API w wersji 3) znajdziesz w Konsoli interfejsów API Google w sekcji Analytics API.

Więcej informacji o zarządzaniu limitami i o tym, jak dostosować aplikację pod kątem wykorzystania limitu, znajdziesz w artykule Monitorowanie interfejsów API i ograniczanie wykorzystania.