W przypadku interfejsu Data API obowiązują te limity i kwoty:
Jak działają limity
Wszystkie żądania wysyłane do interfejsu Google Analytics Data API w wersji 1 wymagają projektu Google Cloud i podlegają limitom opisanym na tej stronie. Limity są wykorzystywane niezależnie od metody użytej do identyfikacji projektu wywołującego, w tym:
- Żądania uwierzytelnione za pomocą danych logowania OAuth 2.0.
- Żądania uwierzytelniane tylko za pomocą klucza interfejsu API.
Klucze interfejsu API służą do powiązania żądania z konkretnym projektem w chmurze Google Cloud na potrzeby limitów i płatności. Wszystkie wywołania interfejsu API wykonane przy użyciu danych logowania lub klucza interfejsu API z Twojego projektu będą wliczane do odpowiednich limitów projektu i usługi w Google Analytics.
Kategorie limitów
Interfejs Data API ma 4 kategorie limitów żądań: Core, Realtime, Funnel i Chat.
Żądania do interfejsu API dotyczące metod podstawowych są rozliczane w ramach limitów podstawowych. Żądania do interfejsu API dotyczące metod Realtime są rozliczane w ramach limitów Realtime. Żądania API do metod ścieżki wykorzystują limity ścieżki. Żądania API wysyłane do metod Google Chat wykorzystują limity Google Chat. Każde żądanie wykorzystuje tylko jeden rodzaj limitu.
| Kategoria limitu | Metody interfejsu API |
|---|---|
| Core | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports |
| W czasie rzeczywistym | runRealtimeReport |
| Ścieżka | runFunnelReport |
| Czat | properties.chat |
Limity usług w Analytics
Wszystkie żądania wykorzystują limity usługi.
| Nazwa limitu | Limit usługi standardowej | Limit usługi w Analytics 360 |
|---|---|---|
| Tokeny podstawowe na usługę dziennie | 200 000 | 2 000 000 |
| Podstawowe tokeny na usługę na godzinę | 40 000 | 400 000 |
| Tokeny podstawowe na projekt, usługę i godzinę | 14 000 | 140 tys. |
| Podstawowe równoczesne żądania dotyczące usługi | 10 | 50 |
| Błędy serwera podstawowego na projekt na usługę na godzinę | 10 | 50 |
| Tokeny w czasie rzeczywistym na usługę dziennie | 200 000 | 2 000 000 |
| Tokeny w czasie rzeczywistym na usługę na godzinę | 40 000 | 400 000 |
| Tokeny w czasie rzeczywistym na projekt, usługę i godzinę | 14 000 | 140 tys. |
| Równoczesne żądania w czasie rzeczywistym w przypadku każdej usługi | 10 | 50 |
| Błędy serwera w czasie rzeczywistym na projekt, na usługę, na godzinę | 10 | 50 |
| Tokeny ścieżki na usługę dziennie | 200 000 | 2 000 000 |
| Tokeny ścieżki na usługę na godzinę | 40 000 | 400 000 |
| Tokeny ścieżki na projekt, usługę i godzinę | 14 000 | 140 tys. |
| Równoczesne żądania powiązane ze ścieżką w przypadku każdej usługi | 10 | 50 |
| Błędy serwera w ścieżce w przypadku każdego projektu, każdej usługi i każdej godziny | 10 | 50 |
| Tokeny czatu na usługę dziennie | 3 750 000 | 3 750 000 |
| Tokeny czatu na usługę na godzinę | 500 000 | 500 000 |
- Żądania równoczesne są mierzone liczbą żądań wykonywanych jednocześnie. Aby zmniejszyć liczbę jednoczesnych żądań, poczekaj na zakończenie poprzednich żądań, zanim wyślesz kolejne.
- Błędy serwera to kody 500 i 503. Limity błędów serwera są naliczane tylko wtedy, gdy żądanie spowoduje błąd serwera. Gdy w przypadku pary projekt i usługa wyczerpią się limity błędów serwera, wszystkie żądania wysyłane 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 tokenów na usługę na godzinę i tokenów na projekt na usługę na godzinę. Oznacza to, że zanim wyczerpie się limit „Tokeny na usługę na godzinę”, usługa musi być dostępna w więcej niż 3 projektach.
Usługi mogą wysyłać 120 potencjalnie ograniczonych żądań na godzinę. Wymiary userAgeBracket, userGender, brandingInterest, audienceId i audienceName mogą być objęte progiem. 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ą wykorzystywane przy każdym żądaniu wysyłanym 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 kosztować 10 tokenów lub mniej, ale bardziej złożone żądania (np. zapytania do usługi Analytics Advisor chat) będą zużywać więcej tokenów.
Czynniki wpływające na wykorzystanie tokenów
Dokładny koszt tokenów w przypadku żą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 samą prośbą i danymi bazowymi w usłudze w Google Analytics. Czynniki te mogą powodować wyższe koszty:
- Liczba wierszy: prośba o większą liczbę wierszy.
- Liczba wymiarów i rodzajów danych: uwzględnianie większej liczby wymiarów i rodzajów danych.
- Złożoność filtra: używanie złożonych wyrażeń filtra.
- Długość zakresu dat: zapytanie obejmuje dłuższy okres.
- Moc zbioru danych: wymiary o dużej mocy zbioru (wiele unikalnych wartości, np.
pagePath, wymiary niestandardowe) mogą znacznie zwiększyć koszt tokenów. - Liczba zdarzeń w usłudze: zapytania dotyczące usług o większej liczbie zdarzeń mogą zużywać więcej tokenów niż to samo zapytanie dotyczące usługi z mniejszą ilością danych.
Monitorowanie wykorzystania tokenów
Najskuteczniejszym sposobem określenia kosztu tokenów w przypadku konkretnych wywołań interfejsu API jest uwzględnienie w treści żądania parametru "returnPropertyQuota": true.
Odpowiedź interfejsu API będzie zawierać obiekt PropertyQuota, który zawiera szczegółowe informacje o tokenach wykorzystanych przez to konkretne żądanie oraz o pozostałych limitach.
Wykorzystanie tokenów w Google Chat i monitorowanie
W przypadku zapytań do usługi Analytics Advisor chat tokeny reprezentują koszty obliczeń modelu, rozumowania i pobierania danych bazowych. Na wykorzystanie tokenów w Google Chat wpływają:
- Zakres zapytania i analizy: złożoność i zakres żądanej analizy.
- Tokeny wejściowe i wyjściowe modelu: ilość przetworzonych danych kontekstowych i wygenerowanych odpowiedzi.
- Tokeny myślenia: kroki rozumowania modelu wymagane do syntezy wyników.
- Opóźnienie wykonania: czas przetwarzania wymagany w przypadku wieloetapowego eksploracyjnego analizowania danych.
Aby monitorować wykorzystanie tokenów czatu, ustaw "returnPropertyQuota": true w ChatRequest. Odpowiedź będzie zawierać obiekt PropertyChatQuota z polami tokensPerDay i tokensPerHour, które zawierają wykorzystane i pozostałe środki.