W przypadku interfejsu Data API obowiązują te limity i kwoty:
Jak stosowane są 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 3 kategorie limitów żądań: Core, Realtime i Funnel. Żądania API wysyłane do metod podstawowych są rozliczane w ramach limitów podstawowych. Żądania API dotyczące metod Czas rzeczywisty obciążają limity Czasu rzeczywistego. Każda prośba 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 |
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 rdzeni na projekt, usługę i godzinę | 14 000 | 140 tys. |
| Podstawowa liczba równoczesnych żądań w przypadku 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 dotyczące usługi | 10 | 50 |
| Błędy serwera w czasie rzeczywistym na projekt, właściwość i 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 |
- Równoczesne żądania 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.
- 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 żądań potencjalnie przekraczających limit 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 tokenów, za które pobierana jest opłata, 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 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 precyzyjne obliczenia z wyprzedzeniem. Koszt zależy od kombinacji czynników związanych z samą prośbą i danymi bazowymi w usłudze w Google Analytics. Te czynniki 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.