Method: properties.runPivotReport

Zwraca dostosowany raport przestawny danych zdarzeń Google Analytics. Raporty przestawne są bardziej zaawansowane i zawierają więcej informacji niż zwykłe raporty. W raporcie przestawnym wymiary są widoczne tylko wtedy, gdy zostały uwzględnione w tabeli przestawnej. Aby dokładniej przeanalizować dane, możesz użyć wielu tabel przestawnych.

Żądanie HTTP

POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runPivotReport

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
property

string

Identyfikator usługi w GA4 w Google Analytics, której zdarzenia są śledzone. Jest określona w ścieżce adresu URL, a nie w treści. Więcej informacji znajdziesz w sekcji, gdzie możesz znaleźć identyfikator usługi. W żądaniu zbiorczym ta właściwość powinna być nieokreślona lub spójna z właściwością na poziomie wsadu.

Przykład: properties/1234

Treść żądania

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

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

object (Dimension)

Żądane wymiary. Wszystkie zdefiniowane wymiary muszą być używane przez jeden z następujących elementów: r.Expression, dimensionFilter, przestaws, orderBys.

metrics[]

object (Metric)

Żądane wskaźniki. Musisz określić co najmniej jeden rodzaj danych. Wszystkie zdefiniowane dane muszą być używane przez jeden z tych elementów: „metric_expression”, „metricFilter” (wyrażenie_metryczne) lub „orderBys”.

dateRanges[]

object (DateRange)

Zakres dat, z którego mają zostać pobrane dane zdarzenia z raportu. Jeśli określisz wiele zakresów dat, w raporcie zostaną użyte dane o zdarzeniach z każdego z tych zakresów. W nazwach pól w tabeli przestawnej może zostać uwzględniony wymiar specjalny o nazwie „dateRange”. Jeśli go znajdziesz, raport będzie porównywał wartości w różnych zakresach dat. W żądaniu dotyczącym kohorty parametr dateRanges musi być nieokreślony.

pivots[]

object (Pivot)

Opisuje format wizualny wymiarów raportu w kolumnach lub wierszach. Połączenie pola fieldNames (nazwy wymiarów) we wszystkich tabelach musi być podzbiorem nazw wymiarów zdefiniowanych w sekcji Wymiary. Żadne 2 tabele przestawne nie mogą mieć wspólnego wymiaru. Wymiar jest widoczny tylko wtedy, gdy występuje w tabeli przestawnej.

dimensionFilter

object (FilterExpression)

Klauzula filtra wymiarów. Aby użyć wymiarów w tym filtrze, musisz zażądać wymiarów. W tym filtrze nie można używać danych.

metricFilter

object (FilterExpression)

Klauzula filtra wskaźników. Stosowane na etapie agregacji, podobnie jak w przypadku klauzuli SQL. Aby użyć danych w tym filtrze, musisz zażądać wskaźników. W tym filtrze nie można używać wymiarów.

currencyCode

string

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

cohortSpec

object (CohortSpec)

Grupa kohorty powiązana z tym żądaniem. Jeśli żądanie zawiera grupę kohorty, musi być obecny wymiar „kohorta”.

keepEmptyRows

boolean

Jeśli zasada ma wartość Fałsz lub jest nieokreślona, każdy wiersz ze wszystkimi danymi równymi 0 nie jest zwracany. Jeśli ma wartość true (prawda), te wiersze zostaną zwrócone, jeśli nie zostaną osobno usunięte przez filtr.

Niezależnie od tego ustawienia keepEmptyRows w raporcie mogą być wyświetlane tylko dane zarejestrowane przez usługę w Google Analytics (GA4).

Jeśli np. usługa nigdy nie rejestruje zdarzenia purchase, zapytanie dotyczące wymiaru eventName i danych eventCount nie będzie zawierać wiersza eventName: „purchase” i wyniku eventCount: 0.

returnPropertyQuota

boolean

Określa, czy ma być zwracany bieżący stan limitu tej usługi 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 OAuth:

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