Method: runPivotReport

Zwraca niestandardowy raport przestawny danych zdarzeń Google Analytics. Raporty przestawne są bardziej zaawansowane i ekspresyjne niż zwykłe raporty. W raporcie przestawnym wymiary są widoczne tylko wtedy, gdy znajdują się w tabeli przestawnej. Możesz określić wiele przestawnych danych, aby dokładniej przeanalizować dane.

Żądanie HTTP

POST https://analyticsdata.googleapis.com/v1alpha:runPivotReport

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "entity": {
    object (Entity)
  },
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "pivots": [
    {
      object (Pivot)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean
}
Pola
entity

object (Entity)

Usługa, której zdarzenia są śledzone. W żądaniu zbiorczym ta encja powinna być nieokreślona lub zgodna z elementem na poziomie wsadu.
dimensions[]

object (Dimension)

Żądane wymiary. Wszystkie zdefiniowane wymiary muszą być używane w jednym z tych wymiarów: orderExpression, dimensionsFilter, przestaw lub orderBys.
metrics[]

object (Metric)

Żądane dane, należy określić co najmniej jeden rodzaj danych. Wszystkie zdefiniowane dane muszą być używane przez: metric_expression, metricFilter lub orderBys.
dimensionFilter

object (FilterExpression)

Klauzula filtrowania wymiarów. Użycie wymiarów w tym filtrze wymaga wysłania prośby o przesłanie prośby. W tym filtrze nie można używać danych.
metricFilter

object (FilterExpression)

Klauzula filtra wskaźników. Stosowane na etapie po agregacji, podobnie jak w klauzuli SQL. Aby ich używać w tym filtrze, musisz poprosić o ich użycie. W tym filtrze nie można używać wymiarów.
pivots[]

object (Pivot)

Opisuje format wizualny wymiarów raportu w kolumnach lub wierszach. Połączenie wartości „fieldNames” (nazw wymiarów) we wszystkich przestawieniach musi być podzbiorem nazw wymiarów zdefiniowanych w sekcji Wymiary. Jeden wymiar nie może być używany przez 2 przestawienia. Wymiar jest widoczny tylko wtedy, gdy znajduje się w tabeli przestawnej.
dateRanges[]

object (DateRange)

Zakres dat, z którego mają zostać pobrane dane zdarzeń na potrzeby raportu. Jeśli określisz wiele zakresów dat, w raporcie zostaną wykorzystane dane o zdarzeniach z każdego z nich. Wymiar specjalny o nazwie pola „dateRange” można umieścić w nazwach pól tabeli przestawnej; jeśli zostaną uwzględnione, raport porówna poszczególne zakresy dat. W żądaniu dotyczącym kohorty wartość dateRanges musi być nieokreślona.
currencyCode

string

Kod waluty w formacie ISO4217, np. „AED”, „USD” lub „JPY”. Jeśli to pole jest puste, raport używa domyślnej waluty elementu.
cohortSpec

object (CohortSpec)

Grupa kohort powiązana z tym żądaniem. Jeśli w żądaniu znajduje się grupa kohortowa, „kohorta” wymiar musi być podany.
keepEmptyRows

boolean

Jeśli wartość to fałsz lub nieokreślona wartość, nie zostaną zwrócone żadne wiersze z żadnymi danymi równymi 0. Jeśli tak, wiersze te zostaną zwrócone, jeśli nie zostały usunięte osobno przez filtr.
returnPropertyQuota

boolean

Określa, czy ma być zwracany bieżący stan limitu tej usługi w Analytics. Limit jest zwracany w polu PropertyQuota.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu RunPivotReportResponse.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics