Limity dotyczące żądań do interfejsu API

W tym dokumencie opisano limity dotyczące interfejsów API zarządzania i interfejsów API do raportowania.

Usługa Google Analytics jest używana przez miliony witryn. Ograniczenia dotyczące żądań do interfejsu API chronią limity, aby chronić system przed otrzymywaniem większej ilości danych niż może obsłużyć oraz zapewnić równomierny rozkład zasobów systemowych. Limity mogą się zmieniać.

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

Ogólne limity

W przypadku interfejsów Management API, Core Reporting API 3, MCF Reporting API, Metadata API, User Deletion API i interfejsu API do raportowania w czasie rzeczywistym obowiązują następujące limity:

  • 50 tys. żądań na projekt dziennie, co można zwiększyć.
  • 10 zapytań na sekundę (QPS) na adres IP.
    • W interfejsie API obowiązuje podobny limit, określany jako Żądania na 100 sekund na użytkownika. Domyślnie jest ustawiony na 100 żądań na 100 sekund na użytkownika i można go zmienić do maksymalnej wartości 1000 żądań. Liczba żądań do interfejsu API jest ograniczona do 10 żądań na sekundę na użytkownika.
    • Jeśli aplikacja wysyła wszystkie żądania API z jednego adresu IP (np. w imieniu użytkowników), do każdego żądania podaj parametr userIP lub quotaUser, aby uzyskać pełny limit zapytań na sekundę. Szczegółowe informacje znajdziesz w podsumowaniu standardowych parametrów zapytania.

Reporting APIs

Poniższe limity dotyczą wszystkich interfejsów API raportowania, między innymi Core Reporting API w wersji 3, Analytics Reporting API 4, Real Time API v3 i Multi-channel API v3:

  • 10 000 żądań na wyświetlenie (profil) dziennie (nie można zwiększyć)
  • 10 żądań równoczesnych na wyświetlenie (profil) (nie można zwiększyć),

Błędy żądań raportów API

Jeśli żądanie do interfejsu Reporting API nie powiedzie się z powodu błędu serwera, otrzymasz kod odpowiedzi 500 lub 503. Możesz ponownie przesłać zgłoszenie, ale jeśli nie powiedzie się, zrób to tylko raz. Google Analytics umożliwia:

  • 10 nieudanych żądań serwera na projekt na widok (profil) na godzinę
  • 50 nieudanych żądań serwera na projekt na widok (profil) dziennie

Jeśli liczba nieudanych żądań przekracza te limity, wystąpi 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 żądania, uprość żądanie, zmniejszając zakres dat, zmniejszając liczbę wymiarów w żądaniu lub zmniejszając liczbę danych w żądaniu.

Nie przesyłaj ponownie nieudanych żądań. Aby ponownie ją przesłać, zastosuj wykładnicze odliczanie.

Limity liczby błędów serwera są egzekwowane w stosunku do cyklicznych przedziałów czasu w przypadku każdego limitu godzinowego i dziennego. Po upływie 1 godziny od utworzenia projektu i wyświetleniu pierwszego błędu serwera limit zostaje zresetowany. Jeśli para projektu i widoku wysyła w ciągu godziny 10 błędów serwera, para projektu i widoku jest blokowana przez interfejs API, dopóki nie upłynie pierwsza godzina błędu serwera.

Jeśli na przykład para projektu i widoku nie wysłała błędu serwera w ciągu ostatnich 24 godzin, ten projekt i widok wykorzysta 0 ze swojego 50 limitu. Załóżmy, że ten projekt i widok powodują wysyłanie błędu serwera o 6:12. Jeśli ten projekt i widok spowodują wysłanie 49 dodatkowych błędów serwera przed godziną 6:12 kolejnego dnia, projekt i widok zostaną zablokowane do godziny 6:12 kolejnego dnia. O 6:12 następnego dnia limit błędów serwera zostanie całkowicie zresetowany do tego projektu i widoku.

Przekroczono limit

Jeśli limit żądania do interfejsu Google Analytics API został przekroczony, interfejs API zwraca kod błędu 403 lub 429 oraz wyświetla komunikat, że konto przekroczyło limit. Więcej informacji znajdziesz w Warunkach korzystania z usługi.

Prośba o dodatkowy limit

Możesz poprosić tylko o zwiększenie:

Aby wyświetlić lub zmienić limity wykorzystania projektu lub poprosić o jego zwiększenie, wykonaj te czynności:

  1. Jeśli nie masz jeszcze konta rozliczeniowego na potrzeby swojego projektu, je utwórz.
  2. W konsoli API otwórz stronę „Włączone interfejsy API” i wybierz z listy interfejs API.
  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 limitu, skorzystaj z formularza prośby o zwiększenie limitu. Zapoznaj się z tymi informacjami i postępuj zgodnie z instrukcjami podanymi w formularzu żądania limitu. W przypadku interfejsu Reporting API w wersji 4 nazwa interfejsu API w konsoli Google API to Google Analytics Reporting API. Wszystkie pozostałe interfejsy API wersji 3 (np. Interfejs API zarządzania w wersji 3, Core Reporting API 3, Interfejs API do raportowania w czasie rzeczywistym w wersji 3 i User Deletion API w wersji 3 znajdziesz w interfejsie Analytics API w konsoli Google API.

Więcej informacji o zarządzaniu limitami i dostosowywaniu aplikacji do limitów znajdziesz w artykule Monitorowanie interfejsów API i ograniczanie wykorzystania.