W przypadku interfejsu Data API obowiązują te limity i limity przydziału.
Jak działają limity przydziału
Wszystkie żądania do interfejsu Google Analytics Data API w wersji 1 wymagają projektu Google Cloud i podlegają limitom przydziału określonym na tej stronie. Limity przydziału są wykorzystywane niezależnie od metody używanej do identyfikowania projektu wywołującego, w tym:
- żądania uwierzytelnione za pomocą danych logowania OAuth 2.0;
- żądania uwierzytelnione tylko za pomocą klucza interfejsu API.
Klucze interfejsu API służą do powiązania żądania z konkretnym projektem w chmurze Google Cloud na potrzeby limitu i rozliczeń. Wszystkie wywołania interfejsu API wykonywane przy użyciu danych logowania lub klucza interfejsu API z Twojego projektu będą wliczane do odpowiednich limitów przydziału projektu i usługi Google Analytics.
Kategorie limitów przydziału
Interfejs Data API ma 3 kategorie limitów przydziału żądań: Rdzeń, Czas rzeczywisty i Ścieżka. Żądania do interfejsu API wysyłane do metod Rdzeń wykorzystują limity przydziału Rdzeń. Żądania do interfejsu API wysyłane do metod Czas rzeczywisty wykorzystują limity przydziału Czas rzeczywisty. Każde żądanie wykorzystuje tylko 1 rodzaj limitu przydziału.
| Kategoria limitu przydziału | Metody interfejsu API |
|---|---|
| Mięśnie głębokie | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports |
| W czasie rzeczywistym | runRealtimeReport |
| Ścieżka | runFunnelReport |
Limity przydziału usługi Analytics
Wszystkie żądania wykorzystują limity przydziału usługi.
| Nazwa limitu przydziału | Limit w usłudze standardowej | Limit w usłudze w Analytics 360 |
|---|---|---|
| Tokeny Rdzeń na usługę dziennie | 200 000 | 2 000 000 |
| Tokeny Rdzeń na usługę na godzinę | 40 000 | 400 000 |
| Tokeny Rdzeń na projekt na usługę na godzinę | 14 000 | 140 000 |
| Równoczesne żądania Rdzeń na usługę | 10 | 50 |
| Błędy serwera Rdzeń na projekt na usługę na godzinę | 10 | 50 |
| Tokeny Czas rzeczywisty na usługę dziennie | 200 000 | 2 000 000 |
| Tokeny Czas rzeczywisty na usługę na godzinę | 40 000 | 400 000 |
| Tokeny Czas rzeczywisty na projekt na usługę na godzinę | 14 000 | 140 000 |
| Równoczesne żądania Czas rzeczywisty na usługę | 10 | 50 |
| Błędy serwera Czas rzeczywisty na projekt na usługę na godzinę | 10 | 50 |
| Tokeny Ścieżka na usługę dziennie | 200 000 | 2 000 000 |
| Tokeny Ścieżka na usługę na godzinę | 40 000 | 400 000 |
| Tokeny Ścieżka na projekt na usługę na godzinę | 14 000 | 140 000 |
| Równoczesne żądania Ścieżka na usługę | 10 | 50 |
| Błędy serwera Ścieżka na projekt na usługę na godzinę | 10 | 50 |
- Równoczesne żądania są mierzone liczbą żądań wykonywanych jednocześnie. Aby zmniejszyć liczbę równoczesnych żądań, poczekaj, aż poprzednie żądania zostaną zrealizowane, zanim wyślesz kolejne.
- Błędy serwera to kody 500 i 503. Limity przydziału błędów serwera są naliczane tylko wtedy, gdy żądanie spowoduje błąd serwera. Gdy limity przydziału błędów serwera dla pary projekt i usługa zostaną wyczerpane, wszystkie żądania do usługi z projektu zostaną zablokowane. Pełną listę odpowiedzi na błędy znajdziesz w sekcji Odpowiedzi na błędy.
- Każde żądanie wykorzystuje limit przydziału zarówno Tokeny na usługę na godzinę, jak i Tokeny na projekt na usługę na godzinę. Oznacza to, że zanim limit przydziału „Tokeny na usługę na godzinę” zostanie wyczerpany przed limitem przydziału „Tokeny na projekt na usługę na godzinę”, do 1 usługi musi mieć dostęp więcej niż 3 projekty.
Usługi mogą wysyłać maksymalnie 120 żądań na godzinę, które mogą podlegać wartościom progowym. Wymiary userAgeBracket, userGender, brandingInterest, audienceId i audienceName mogą podlegać wartościom progowym. Stosowanie wartości progowych zapobiega poznawaniu danych demograficznych i zainteresowań poszczególnych użytkowników przez osoby wyświetlające raport.
Limit przydziału tokenów usługi
Tokeny są wykorzystywane przy każdym żądaniu do interfejsu Google Analytics Data API w wersji 1. Liczba naliczonych tokenów zależy od złożoności żądania. Większość żądań będzie wykorzystywać 10 lub mniej tokenów, ale bardziej złożone żądania będą wykorzystywać ich więcej.
Czynniki wpływające na wykorzystanie tokenów
Dokładny koszt tokena dla żądania jest określany w momencie jego wykonania, co utrudnia dokładne obliczenie z wyprzedzeniem. Koszt zależy od kombinacji czynników związanych z samym żądaniem i danymi bazowymi w usłudze w Google Analytics. Te czynniki mogą powodować wyższe koszty:
- Liczba wierszy: żądanie większej liczby wierszy.
- Liczba wymiarów i danych: uwzględnienie większej liczby wymiarów i danych.
- Złożoność filtra: używanie złożonych wyrażeń filtra.
- Długość zakresu dat: wysyłanie zapytań dotyczących dłuższych okresów.
- Moc zbioru danych: wymiary o dużej mocy zbioru (wiele unikalnych wartości, np.
pagePath, wymiary niestandardowe) mogą znacznie zwiększyć koszt tokena. - Liczba zdarzeń w usłudze: zapytania dotyczące usług z większą liczbą zdarzeń mogą wykorzystywać więcej tokenów niż to samo zapytanie dotyczące usługi z mniejszą ilością danych.
Monitorowanie wykorzystania tokenów
Najskuteczniejszym sposobem na określenie kosztu tokena w przypadku konkretnych wywołań interfejsu API
jest dodanie parametru "returnPropertyQuota": true w treści żądania.
Odpowiedź interfejsu API będzie wtedy zawierać obiekt PropertyQuota, który zawiera szczegółowe informacje o tokenach wykorzystanych przez to konkretne żądanie oraz o pozostałych limitach przydziału.