Method: properties.runPivotReport

Retorna um relatório dinâmico personalizado dos dados de eventos do Google Analytics. Os relatórios dinâmicos são formatos mais avançados e expressivos do que os relatórios normais. Em um relatório dinâmico, as dimensões só ficam visíveis se forem incluídas em uma tabela dinâmica. Várias tabelas dinâmicas podem ser especificadas para analisar melhor os dados.

Solicitação HTTP

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

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 rastreados. Especificado no caminho do URL e não no corpo. Para saber mais, consulte Onde encontrar o ID da propriedade. Em uma solicitação em lote, essa propriedade precisa ser não especificada ou consistente com a propriedade no nível do lote.

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)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "pivots": [
    {
      object (Pivot)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean,
  "comparisons": [
    {
      object (Comparison)
    }
  ]
}
Campos
dimensions[]

object (Dimension)

As dimensões solicitadas. Todas as dimensões definidas precisam ser usadas por um dos seguintes elementos: dimensionExpression, dimensionFilter, pivots, orderBys.
metrics[]

object (Metric)

As métricas solicitadas. Pelo menos uma métrica precisa ser especificada. Todas as métricas definidas precisam ser usadas por um dos seguintes elementos: metric_expression, metricFilter, orderBys.
dateRanges[]

object (DateRange)

O período para recuperar dados de eventos do relatório. Se vários períodos forem especificados, os dados de eventos de cada período serão usados no relatório. Uma dimensão especial com o nome do campo "dateRange" pode ser incluída nos nomes de campo de uma tabela dinâmica. Se incluída, o relatório compara os períodos. Em uma solicitação de coorte, esse dateRanges precisa ser não especificado.
pivots[]

object (Pivot)

Descreve o formato visual das dimensões do relatório em colunas ou linhas. A união dos fieldNames (nomes de dimensões) em todas as tabelas dinâmicas precisa ser um subconjunto de nomes de dimensões definidos em Dimensões. Duas tabelas dinâmicas não podem compartilhar uma dimensão. Uma dimensão só fica visível se aparecer em uma tabela dinâmica.
dimensionFilter

object (FilterExpression)

A cláusula de filtro de dimensões. As dimensões precisam ser solicitadas para serem usadas nesse filtro. As métricas não podem ser usadas nesse 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. As métricas precisam ser solicitadas para serem usadas nesse filtro. As dimensões não podem ser usadas nesse filtro.
currencyCode

string

Um código de moeda no formato ISO4217, como "AED", "USD", "JPY". Se o campo estiver vazio, o relatório usará a moeda padrão da propriedade.
cohortSpec

object (CohortSpec)

Grupo de coortes associado a essa solicitação. Se houver um grupo de coortes na solicitação, a dimensão "coorte" precisa estar presente.
keepEmptyRows

boolean

Se for falso ou não especificado, cada linha com todas as métricas iguais a 0 não será retornada. Se for verdadeiro, essas linhas serão retornadas se não forem removidas separadamente por um filtro.

Independente dessa configuração keepEmptyRows, apenas os dados registrados pela propriedade do Google Analytics podem ser mostrados em um relatório.

Por exemplo, se uma propriedade nunca registrar um evento purchase, uma consulta para a dimensão eventName e a métrica eventCount não terá um evento de linha eventName: "purchase" e eventCount: 0.
returnPropertyQuota

boolean

Alterna se o estado atual da cota dessa propriedade do Google Analytics será retornado. A cota é retornada em PropertyQuota.
comparisons[]

object (Comparison)

Opcional. A configuração das comparações solicitadas e mostradas. A solicitação exige um campo de comparações e uma dimensão de comparações para receber uma coluna de comparação na resposta.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de RunPivotReportResponse.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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