Method: properties.runPivotReport

Zwraca niestandardowy raport kolumnowo-wierszowy z danymi zdarzeń Google Analytics. Raporty zwierciadlane to bardziej zaawansowane i wyraziste formaty niż zwykłe raporty. W raporcie przestawnym wymiary są widoczne tylko wtedy, gdy są uwzględnione w tabeli przestawnej. Aby jeszcze bardziej uszczegółowić podział danych, możesz określić większą liczbę przekształceń.

Żą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 Google Analytics, której zdarzenia są śledzone. Wskazuje się je w ścieżce adresu URL, a nie w treści. Więcej informacji znajdziesz w sekcji Gdzie znaleźć identyfikator usługi. W żądaniu zbiorczym ta właściwość powinna być nieokreślona lub zgodna z właściwością na poziomie zbiorczego.

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,
  "comparisons": [
    {
      object (Comparison)
    }
  ]
}
Pola
dimensions[]

object (Dimension)

Wymiary żądane. Wszystkie zdefiniowane wymiary muszą być używane przez jedną z tych instrukcji: wyrażenieWymiaru, filtrWymiaru, przestawy, porządek.
metrics[]

object (Metric)

Wymagane dane. Musisz określić co najmniej 1 rodzaj danych. Wszystkie zdefiniowane dane muszą być używane przez jeden z tych elementów: metric_expression, metricFilter, orderBy.
dateRanges[]

object (DateRange)

Zakres dat, z którego mają być pobierane dane zdarzenia do raportu. Jeśli zostanie określony więcej niż 1 zakres dat, w raporcie zostaną wykorzystane dane o zdarzeniach z każdego z nich. W nazwach pól tabeli przestawnej można uwzględnić specjalny wymiar o nazwie „dateRange”. Jeśli tak się stanie, raport będzie porównywać zakresy dat. W prośbie o dane dotyczące kohorty nie można podać wartości parametru dateRanges.
pivots[]

object (Pivot)

Opisuje format wizualny wymiarów raportu w kolumnach lub wierszach. Zbiór nazw pól (nazw wymiarów) we wszystkich przekształceniach musi być podzbiorem nazw wymiarów zdefiniowanych w sekcji Wymiary. Dwa przestawienia nie mogą mieć tego samego wymiaru. Wymiar jest widoczny tylko wtedy, gdy pojawia się w wymiarach osi.
dimensionFilter

object (FilterExpression)

Klauzula filtra wymiarów. Aby wymiary mogły być używane w tym filtrze, musisz je poprosić. W tym filtrze nie można używać danych.
metricFilter

object (FilterExpression)

Klauzula filtra danych. Stosuje się go w fazie po agregacji, podobnie jak w przypadku klauzuli SQL having. Aby dane mogły być używane w tym filtrze, musisz je zażądać. W tym filtrze nie można używać wymiarów.
currencyCode

string

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

object (CohortSpec)

Grupa kohorty powiązana z tym żądaniem. Jeśli w żądaniu występuje grupa kohorty, musi być podany wymiar „cohorta”.
keepEmptyRows

boolean

Jeśli wartość jest równa fałsz lub nie jest określona, nie zostanie zwrócony żaden wiersz, w którym wszystkie dane mają wartość 0. Jeśli to pole ma wartość Prawda, zwrócone zostaną te wiersze, które nie zostały usunięte przez filtr.

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

Jeśli np. usługa nigdy nie rejestruje zdarzenia purchase, zapytanie o wymiar eventName i dane eventCount nie będzie zawierać wiersza eventName: „purchase” ani eventCount: 0.
returnPropertyQuota

boolean

Określa, czy zwracać bieżący stan limitu usługi w Google Analytics. Limit jest zwracany w PropertyQuota.
comparisons[]

object (Comparison)

Opcjonalnie: Konfiguracja żądanych i wyświetlanych porównań. Żądanie wymaga pola porównań i wymiaru porównań, aby otrzymać w odpowiedzi kolumnę porównań.

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