Method: batchRunPivotReports

Retorna vários relatórios dinâmicos em um lote. Todos os relatórios precisam ser sobre a mesma entidade.

Solicitação HTTP

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

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

Corpo da solicitação

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

Representação JSON 
{
  "entity": {
    object (Entity)
  },
  "requests": [
    {
      object (RunPivotReportRequest)
    }
  ]
}
Campos
entity

object (Entity)

Uma propriedade com eventos que são rastreados. Essa entidade precisa ser especificada para o lote. A entidade em RunPivotReportRequest pode não ser especificada ou ser consistente com essa entidade.
requests[]

object (RunPivotReportRequest)

Solicitações individuais. Cada solicitação tem uma resposta de relatório dinâmico diferente. Cada solicitação em lote pode ter até cinco solicitações.

Corpo da resposta

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

A resposta em lote contendo vários relatórios dinâmicos.

Representação JSON 
{
  "pivotReports": [
    {
      object (RunPivotReportResponse)
    }
  ]
}
Campos
pivotReports[]

object (RunPivotReportResponse)

Respostas individuais. Cada resposta tem uma solicitação de relatório dinâmico diferente.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

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

RunPivotReportRequest

A solicitação para gerar um relatório dinâmico.

Representação JSON 
{
  "entity": {
    object (Entity)
  },
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "pivots": [
    {
      object (Pivot)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean
}
Campos
entity

object (Entity)

Uma propriedade com eventos que são rastreados. Em uma solicitação em lote, essa entidade deve ser não especificada ou consistente com a entidade no nível de lote.
dimensions[]

object (Dimension)

As dimensões solicitadas. Todas as dimensões definidas precisam ser usadas por um dos seguintes valores: 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 critérios: metric_expression, metricFilter, orderBys.
dimensionFilter

object (FilterExpression)

A cláusula de filtro das dimensões. É preciso solicitar as dimensões para usar nesse filtro. Não é possível usar métricas neste filtro.
metricFilter

object (FilterExpression)

A cláusula de filtro das métricas. Aplicado na fase pós-agregação, semelhante à cláusula SQL. É preciso solicitar as métricas para usá-las nesse filtro. Não é possível usar dimensões neste filtro.
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ão) em todas as tabelas dinâmicas precisa ser um subconjunto de nomes de dimensão definidos em Dimensões. Duas tabelas dinâmicas não podem compartilhar uma dimensão. Uma dimensão só será visível se aparecer em uma tabela dinâmica.
dateRanges[]

object (DateRange)

O período para recuperar os 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 de campo "dateRange" pode ser incluída nos nomes de campo de uma tabela dinâmica. Se ela for incluída, o relatório fará a comparação entre os períodos. Em uma solicitação de coorte, esse dateRanges não pode ser especificado.
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 entidade.
cohortSpec

object (CohortSpec)

Grupo de coorte associado a esta solicitação. Se houver um grupo de coorte na solicitação, a dimensão "coorte" precisará 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 verdadeiro, essas linhas serão retornadas se não forem removidas separadamente por um filtro.
returnPropertyQuota

boolean

Define se é necessário retornar o estado atual da cota dessa propriedade do Google Analytics. A cota é retornada em PropertyQuota.