Method: properties.runRealtimeReport

Retorna um relatório personalizado dos dados de eventos em tempo real da sua propriedade. Os eventos aparecem nos relatórios em tempo real segundos depois de serem enviados ao Google Analytics. Os relatórios de tempo real mostram eventos e dados de uso para períodos que variam do momento atual até 30 minutos atrás (até 60 minutos para propriedades do Google Analytics 360).

Para um guia sobre como criar solicitações em tempo real e entender as respostas, consulte Como criar um relatório em tempo real.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
property

string

Um identificador de propriedade do Google Analytics cujos eventos são acompanhados. Especificado no caminho do URL, e não no corpo. Para saber mais, consulte onde encontrar o ID da propriedade.

Exemplo: properties/1234

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "limit": string,
  "metricAggregations": [
    enum (MetricAggregation)
  ],
  "orderBys": [
    {
      object (OrderBy)
    }
  ],
  "returnPropertyQuota": boolean,
  "minuteRanges": [
    {
      object (MinuteRange)
    }
  ]
}
Campos
dimensions[]

object (Dimension)

As dimensões solicitadas e exibidas.
metrics[]

object (Metric)

As métricas solicitadas e exibidas.
dimensionFilter

object (FilterExpression)

A cláusula de filtro das dimensões. Não é possível usar métricas neste filtro.
metricFilter

object (FilterExpression)

A cláusula de filtro de métricas. Aplicada na fase de pós-agregação, semelhante à cláusula "having" do SQL. Não é possível usar dimensões neste filtro.
limit

string (int64 format)

O número de linhas que serão retornadas. Se não for especificado, 10.000 linhas serão retornadas. A API retorna um máximo de 250.000 linhas por solicitação, não importa quantas você solicitar. limit precisa ser positivo.

A API também pode retornar menos linhas do que o limit solicitado, se não houver tantos valores de dimensão quanto o limit. Por exemplo, há menos de 300 valores possíveis para a dimensão country. Portanto, ao gerar relatórios apenas com country, não é possível receber mais de 300 linhas, mesmo que você defina limit como um valor maior.
metricAggregations[]

enum (MetricAggregation)

Agregação de métricas. Os valores de métrica agregados vão aparecer em linhas em que os valores de dimensão estão definidos como "RESERVED_(MetricAggregation)".
orderBys[]

object (OrderBy)

Especifica como as linhas são ordenadas na resposta.
returnPropertyQuota

boolean

Alterne se o estado atual da cota em tempo real da propriedade do Google Analytics será retornado. A cota é retornada em PropertyQuota.
minuteRanges[]

object (MinuteRange)

Os intervalos de minutos dos dados de eventos a serem lidos. Se não for especificado, será usada uma faixa de um minuto para os últimos 30 minutos. Se vários intervalos de minutos forem solicitados, cada linha de resposta vai conter um índice de intervalo de minutos com base em zero. Se dois intervalos de minutos se sobrepõem, os dados do evento para os minutos sobrepostos são incluídos nas linhas de resposta para os dois intervalos.

Corpo da resposta

Tabela de relatórios de resposta em tempo real correspondente a uma solicitação.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "dimensionHeaders": [
    {
      object (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "totals": [
    {
      object (Row)
    }
  ],
  "maximums": [
    {
      object (Row)
    }
  ],
  "minimums": [
    {
      object (Row)
    }
  ],
  "rowCount": integer,
  "propertyQuota": {
    object (PropertyQuota)
  },
  "kind": string
}
Campos
dimensionHeaders[]

object (DimensionHeader)

Descreve as colunas de dimensão. O número de DimensionHeaders e a ordem dos DimensionHeaders correspondem às dimensões presentes nas linhas.
metricHeaders[]

object (MetricHeader)

Descreve as colunas de métricas. O número de MetricHeaders e a ordem deles correspondem às métricas presentes nas linhas.
rows[]

object (Row)

Linhas de combinações de valores de dimensão e valores de métrica no relatório.
totals[]

object (Row)

Se solicitado, os valores totais das métricas.
maximums[]

object (Row)

Se solicitado, os valores máximos das métricas.
minimums[]

object (Row)

Se solicitado, os valores mínimos das métricas.
rowCount

integer

O número total de linhas no resultado da consulta. rowCount é independente do número de linhas retornadas na resposta e do parâmetro de solicitação limit. Por exemplo, se uma consulta retornar 175 linhas e incluir limit de 50 na solicitação da API, a resposta vai conter rowCount de 175, mas apenas 50 linhas.
propertyQuota

object (PropertyQuota)

O estado da cota em tempo real dessa propriedade do Google Analytics, incluindo essa solicitação.
kind

string

Identifica o tipo de recurso da mensagem. Esse kind é sempre a string fixa "analyticsData#runRealtimeReport". Útil para distinguir entre tipos de resposta em JSON.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

MinuteRange

Um conjunto contínuo de minutos: startMinutesAgo, startMinutesAgo + 1, ..., endMinutesAgo. As solicitações são permitidas em intervalos de até 2 minutos.

Representação JSON 
{
  "name": string,
  "startMinutesAgo": integer,
  "endMinutesAgo": integer
}
Campos
name

string

Atribui um nome a esse intervalo de minutos. A dimensão dateRange recebe esse nome em uma resposta de relatório. Se definido, não pode começar com date_range_ ou RESERVED_. Se não forem definidos, os intervalos de minutos serão nomeados pelo índice baseado em zero na solicitação: date_range_0, date_range_1 etc.
startMinutesAgo

integer

O minuto de início da consulta como um número de minutos antes do momento atual. Por exemplo, "startMinutesAgo": 29 especifica que o relatório deve incluir dados de eventos de 29 minutos atrás e depois. Não pode ser posterior a endMinutesAgo.

Se não for especificado, startMinutesAgo será definido como 29. As propriedades padrão do Google Analytics podem solicitar até os últimos 30 minutos de dados de eventos (startMinutesAgo <= 29), e as propriedades do Google Analytics 360 podem solicitar até os últimos 60 minutos de dados de eventos (startMinutesAgo <= 59).
endMinutesAgo

integer

O minuto final da consulta como um número de minutos antes do momento atual. Não pode ser anterior a startMinutesAgo. Por exemplo, "endMinutesAgo": 15 especifica que o relatório deve incluir dados de eventos anteriores a 15 minutos.

Se não for especificado, endMinutesAgo vai assumir o valor padrão 0. As propriedades padrão do Google Analytics podem solicitar qualquer minuto dos últimos 30 minutos de dados de eventos (endMinutesAgo <= 29), e as propriedades do Google Analytics 360 podem solicitar qualquer minuto dos últimos 60 minutos de dados de eventos (endMinutesAgo <= 59).