Ta strona została przetłumaczona przez Cloud Translation API.

Method: runReport

Żądanie HTTP
Treść żądania
- Zapis JSON
Treść odpowiedzi
Zakresy autoryzacji
Wypróbuj

Zwraca dostosowany raport z danymi o zdarzeniach w Google Analytics. Raporty zawierają statystyki generowane na podstawie danych zebranych przez kod śledzenia Google Analytics. Dane zwrócone przez interfejs API mają postać tabeli z kolumnami dla żądanych wymiarów i danych. Dane to indywidualne pomiary aktywności użytkowników w usłudze, np. liczba aktywnych użytkowników lub liczba zdarzeń. Wymiary pozwalają podzielić dane według niektórych wspólnych kryteriów, takich jak kraj czy nazwa zdarzenia.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Treść żądania

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

Zapis JSON

Zapis JSON
{ "entity": { object (`Entity`) }, "dimensions": [ { object (`Dimension`) } ], "metrics": [ { object (`Metric`) } ], "dateRanges": [ { object (`DateRange`) } ], "offset": string, "limit": string, "metricAggregations": [ enum (`MetricAggregation`) ], "dimensionFilter": { object (`FilterExpression`) }, "metricFilter": { object (`FilterExpression`) }, "orderBys": [ { object (`OrderBy`) } ], "currencyCode": string, "cohortSpec": { object (`CohortSpec`) }, "keepEmptyRows": boolean, "returnPropertyQuota": boolean }

{
  "entity": {
    object (Entity)
  },
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "offset": string,
  "limit": string,
  "metricAggregations": [
    enum (MetricAggregation)
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "orderBys": [
    {
      object (OrderBy)
    }
  ],
  "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 encją na poziomie wsadu.
`dimensions[]`	`object (Dimension)` Żądane i wyświetlone wymiary.
`metrics[]`	`object (Metric)` Żądane i wyświetlone wskaźniki.
`dateRanges[]`	`object (DateRange)` Zakresy dat danych do odczytania. Jeśli zażądasz kilku zakresów dat, każdy wiersz odpowiedzi będzie zawierał indeks zakresu dat liczony od zera. Jeśli 2 zakresy dat się pokrywają, dane zdarzeń z pokrywających się dni znajdą się w wierszach odpowiedzi dla obu zakresów dat. W żądaniu dotyczącym kohorty pole `dateRanges` musi być nieokreślone.
`offset`	`string (int64 format)` Liczba wierszy wiersza początkowego. Pierwszy wiersz jest liczony jako wiersz 0.
`limit`	`string (int64 format)` Liczba wierszy do zwrócenia. Jeśli parametr `limit` nie jest określony, zwracanych jest 10 000 wierszy. Interfejs API zwraca maksymalnie 100 tys. wierszy na żądanie,niezależnie od tego, ile zażądasz.
`metricAggregations[]`	`enum (MetricAggregation)` Agregacja danych. Zbiorcze wartości danych będą widoczne w wierszach, w których wymiar wymiarValues ma wartość „RESERVED_(MetricAggregation)”.
`dimensionFilter`	`object (FilterExpression)` Klauzula filtra wymiarów. Aby można było użyć wymiarów w tym filtrze, trzeba poprosić o ich zastosowanie. W tym filtrze nie można używać danych.
`metricFilter`	`object (FilterExpression)` Klauzula filtra danych. Stosowane na etapie po agregacji, podobnie jak w przypadku klauzuli SQL. Aby można było użyć danych w tym filtrze, należy poprosić o dane. W tym filtrze nie można używać wymiarów.
`orderBys[]`	`object (OrderBy)` Określa kolejność wierszy w odpowiedzi.
`currencyCode`	`string` Kod waluty w formacie ISO4217, np. „AED”, „USD”, „JPY”. Jeśli to pole jest puste, raport używa domyślnej waluty elementu.
`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 wartość fałsz lub nieokreślona, żaden wiersz ze wszystkimi danymi równymi 0 nie zostanie zwrócony. Jeśli ma wartość true (prawda), te wiersze zostaną zwrócone, jeśli nie zostaną usunięte oddzielnie przez filtr.
`returnPropertyQuota`	`boolean` Określa, czy zwracać bieżący stan limitu tej usługi Analytics. Limit jest zwracany w ramach PropertyQuota.

Treść odpowiedzi

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

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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