Każde żądanie do interfejsu API sprawdza, czy limity nie zostały wyczerpane i wykorzystują limity. Jeśli limit zostanie wyczerpany, żądanie zakończy się niepowodzeniem i wyświetli się odpowiedni komunikat o błędzie. Każde żądanie do interfejsu Data API sprawdza kilka zasobników limitów.
Kategorie limitów
Ze względu na limit interfejsu Data API ma 3 kategorie żądań: Core, Czas rzeczywisty i Ścieżka. Żądania do interfejsu API wysyłane do metod podstawowych obciążają limity podstawowe. Żądania API wysyłane do metod czasu rzeczywistego obciążają limity w czasie rzeczywistym. 1 żądanie nie spowoduje wykorzystania zarówno limitów podstawowych, jak i limitów w czasie rzeczywistym. Oto metody i kategorie interfejsów API:
| Kategoria limitu | Metody interfejsu API |
|---|---|
| Core | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports |
| W czasie rzeczywistym | runRealtimeReport |
| Ścieżka | runFunnelReport |
Limity usługi Analytics
Wszystkie żądania wykorzystują limity usługi.
| Nazwa limitu | Limit usługi standardowej | Limit usług w Analytics 360 |
|---|---|---|
| Liczba podstawowych tokenów usługi na dzień | 200 000 | 2 000 000 |
| Liczba podstawowych tokenów usługi na godzinę | 40 000 | 400 000 |
| Liczba podstawowych tokenów na projekt na usługę na godzinę | 14 000 | 140 tys. |
| Podstawowe żądania równoczesne na usługę | 10 | 50 |
| Liczba podstawowych błędów serwera na projekt na usługę na godzinę | 10 | 50 |
| Liczba tokenów czasu rzeczywistego na usługę na dzień | 200 000 | 2 000 000 |
| Liczba tokenów czasu rzeczywistego na usługę na godzinę | 40 000 | 400 000 |
| Liczba tokenów czasu rzeczywistego na projekt na usługę na godzinę | 14 000 | 140 tys. |
| Równoczesne żądania w czasie rzeczywistym na usługę | 10 | 50 |
| Błędy serwera w czasie rzeczywistym na projekt na usługę na godzinę | 10 | 50 |
| Liczba tokenów ścieżki na usługę dziennie | 200 000 | 2 000 000 |
| Liczba tokenów ścieżki na usługę na godzinę | 40 000 | 400 000 |
| Liczba tokenów ścieżki na projekt na usługę na godzinę | 14 000 | 140 tys. |
| Liczba równoczesnych żądań na ścieżce na usługę | 10 | 50 |
| Liczba błędów serwera ścieżki na projekt na usługę na godzinę | 10 | 50 |
- Liczba żądań równoczesnych jest mierzona na podstawie liczby żądań realizowanych jednocześnie. Aby zmniejszyć równoczesność żądań, zanim wyślesz kolejne żądania, poczekaj na zakończenie poprzednich żądań.
- Błędy serwera to kody 500 i 503. Limity związane z błędami serwera są naliczane tylko w przypadku żądania z błędami serwera. W przypadku wyczerpania limitów związanych z błędami serwera dla pary projekt i usługa wszystkie żądania wysyłane z projektu do usługi są blokowane.
- Każde żądanie zużywa limit tokenów na godzinę oraz liczbę tokenów na projekt na usługę na godzinę. Oznacza to, że do 1 usługi muszą mieć dostęp co najmniej 3 projekty, aby limit „Tokenów na usługę na godzinę” mógł zostać wyczerpany przed osiągnięciem limitu „Tokeny na projekt na usługę na godzinę”.
Dla usług dozwolonych jest 120 żądań, które mogą przekroczyć próg na godzinę. Wymiary userAgeBracket, userGender, brandingInterest, audienceId i audienceName mogą zostać zaklasyfikowane jako wartości progowe. Stosowanie wartości progowych zapobiega poznawaniu danych demograficznych i zainteresowań poszczególnych użytkowników przez osoby wyświetlające raport.
Limit tokenów usługi
Tokeny są obliczane przy każdym żądaniu w zależności od jego złożoności. Większość żądań spowoduje obciążenie maksymalnie 10 tokenów. Gdy żądanie wykorzystuje dużą liczbę tokenów limitu, często przyczyną są te czynniki:
- Duża liczba wierszy
- Duża liczba kolumn
- Złożone kryteria filtrowania
- Długi zakres dat
W przypadku każdego żądania do interfejsu API możesz podać w treści żądania "returnPropertyQuota": true, które zwraca bieżący stan tokenów limitu usługi. Ten stan obejmuje ilość zużywaną przez to żądanie oraz pozostałą ilość dla każdej grupy limitów. Możesz na przykład podać ten parametr w funkcji RunReportRequest.