Limity i kwoty interfejsu API danych

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 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ę i 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, 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
  • Żą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.
  • 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ą obliczane przy każdym żądaniu w zależności od jego złożoności. Większość żądań będzie kosztować 10 tokenów lub mniej. Gdy żądanie zużywa dużą liczbę tokenów limitu, często odpowiadają za to te czynniki:

  • Duża liczba wierszy
  • Duża liczba kolumn
  • Złożone kryteria filtra
  • Długi zakres dat

W każdym żądaniu do interfejsu API możesz określić "returnPropertyQuota": true w treści żądania, aby zwrócić bieżący stan tokenów limitu usługi. Ten stan zawiera zarówno ilość wykorzystaną przez to żądanie, jak i ilość pozostałą w każdej grupie limitów. Możesz na przykład określić ten parametr w pliku RunReportRequest.