Limit oparty na zasobach

W tym dokumencie opisujemy system limitów opartych na zasobach na potrzeby interfejsu Google Analytics Reporting API w wersji 4, który jest dostępny tylko dla klientów Analytics 360. Pełny zestaw limitów obowiązujących w przypadku interfejsów API znajdziesz w artykule Limity i limity interfejsu API.

Wstęp

Aby zapewnić dostępność i niezawodność udostępnionych zasobów, każdy projekt, który uzyskuje dostęp do interfejsu Analytics Reporting API, podlega ograniczeniom i limitom. W przypadku zapytań dotyczących dużych zbiorów danych w interfejsie Analytics Reporting API może być stosowane próbkowanie, które może mieć wpływ na wyniki zbieranych danych.

System limitów opartych na zasobach to nowy system limitów, który umożliwi stosowanie na kontach Analytics 360 wyższych progów próbkowania podczas korzystania z interfejsu Analytics Reporting API. Ten system jest opcjonalny i niezależny od istniejących limitów nałożonych na widoki i projekty, takich jak te raportowane na stronie limitów w Konsoli interfejsów API Google.

Limit na podstawie zasobów

Nie wszystkie żądania są sobie równe. Niektóre żądania są znacznie droższe od innych. System limitów opartych na zasobach został zaprojektowany tak, aby obsługiwać wyższy próg próbkowania, a jednocześnie chronić infrastrukturę raportowania Analytics.

Do każdej usługi zostanie przydzielona określona liczba tokenów zasobów zapytań. Klient interfejsu API może dodać do żądania do interfejsu API opcjonalne pole, aby uzyskać wyższy próg próbkowania w zamian za względne tokeny zasobów zapytania. Bardziej droższe żądanie wymaga większej liczby tokenów.

Próg próbkowania

Żądania danych za pomocą interfejsu Google Analytics API w wersji 4 podlegają tym ogólnym progom próbkowania zależnym od liczby sesji w wybranym zakresie dat (na poziomie usługi):

  • Analytics (wersja standardowa): 500 tys. sesji
  • Analytics 360: 1 mln sesji
  • Analytics 360 z limitem opartym na zasobach: 100 mln sesji

Włącz limit oparty na zasobach

Aby włączyć limity oparte na zasobach w przypadku danego żądania, wywołanie interfejsu API musi zawierać opcjonalne pole useResourceQuotas w metodzie batchGet.

{
  "reportRequests": [{object(ReportRequest)}],
  "useResourceQuotas": boolean,
}

Na przykład:

{
  "reportRequests":[
  {
    "viewId":"XXXX",
    "dateRanges":[
      {
        "startDate":"2017-06-15",
        "endDate":"2017-06-30"
      }],
    "metrics":[
      {
        "expression":"ga:sessions"
      }],
    "dimensions": [
      {
        "name":"ga:browser"
      }]
    }],
  "useResourceQuotas": true
}

Pole odpowiedzi na zapytanie dotyczące kosztu zasobów

Dla każdego wywołania metody batchGet odpowiedź będzie zawierała pole queryCost.

{
  "reports": [{ object(Report) }],
  "queryCost": number
}

Pole queryCost jest liczbą całkowitą określającą łączny koszt zasobów wszystkich ReportRequests w żądaniu batchGet. Na przykład:

{
  "reports": [
    {
      "columnHeader": {...},
      "data": {
        "rows": [...]
      }
    }
  ],
  "queryCost": 1337
}

Przydzielanie limitu

Limit usługi w Analytics 360

  • 100 000 jednostek kosztu zapytań dziennie na usługę.
  • 25 000 jednostek kosztu zapytań na godzinę na usługę.

Jeśli przekroczysz limit, wyświetli się RESOURCE_EXHAUSTED błąd. Więcej informacji znajdziesz w sekcji Odpowiedzi na błędy.

Obliczenia kosztów

Koszt żądania jest proporcjonalny do:

  • Rozmiar zakresu dat.
  • Liczba działań w widoku.
  • Moc zbioru żądanych wymiarów.
  • Liczba żądanych wymiarów i danych.
  • złożoność definicji segmentów i filtrów;
  • stan przetwarzania żądanych informacji (żądanie danych z bieżącego dnia jest droższe niż żądanie danych z poprzedniego dnia).
  • Obecność wymiarów i danych Import podczas zapytań.

Ograniczenia i wykorzystanie interfejsów API

Oprócz systemu limitów opartego na zasobach interfejsy API podlegają też ograniczeniom w interfejsie Analytics API w wersji 4.

Uwagi

  • Pole odpowiedzi queryCost podaje koszt obliczeniowy żądania. Korzystanie z interfejsu API nie wiąże się z żadnymi kosztami, a korzystanie z interfejsu API jest bezpłatne.
  • Raporty z danymi częściowymi i niektórymi danymi historycznymi (sprzed 1 roku) mogą nadal być objęte próbkowaniem, niezależnie od ustawienia useResourceQuotas.
  • Jeśli dla żądania nie uda się spełnić wyższego progu próbkowania, tokeny limitu zasobów nie zostaną odjęte (próbkowane odpowiedzi zawsze mają zerowy koszt limitu zasobów).
  • Raport zawiera próbkowane dane, jeśli w odpowiedzi znajdują się pola samplesReadCounts i samplingSpaceSizes.

Aby wyświetlić lub zmienić limity wykorzystania w projekcie albo poprosić o zwiększenie limitu, wykonaj te czynności:

  1. Jeśli nie masz jeszcze konta rozliczeniowego powiązanego z projektem, utwórz je.
  2. Otwórz stronę Włączone interfejsy API w bibliotece interfejsów API w konsoli API i wybierz interfejs API z listy.
  3. Aby wyświetlić i zmienić ustawienia związane z limitami, wybierz Limity. Aby wyświetlić statystyki użytkowania, wybierz Użycie.