Method: properties.batchRunPivotReports

Retorna vários relatórios de pivot em um lote. Todos os relatórios precisam ser da mesma propriedade do Google Analytics.

Solicitação HTTP

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

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. Essa propriedade precisa ser especificada para o lote. A propriedade em RunPivotReportRequest pode ser não especificada ou consistente com essa propriedade.

Exemplo: properties/1234

Corpo da solicitação

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

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

object (RunPivotReportRequest)

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

Corpo da resposta

A resposta em lote que contém vários relatórios de pivot.

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

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

object (RunPivotReportResponse)

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

string

Identifica o tipo de recurso da mensagem. Esse kind é sempre a string fixa "analyticsData#batchRunPivotReports". Ú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

RunPivotReportRequest

A solicitação para gerar um relatório pivot.

Representação JSON 
{
  "property": string,
  "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
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. 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
dimensions[]

object (Dimension)

As dimensões solicitadas. Todas as dimensões definidas precisam ser usadas por uma das seguintes opções: 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 uma das seguintes opções: 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 um deles serão usados no relatório. Uma dimensão especial com o nome de campo "dataRange" pode ser incluída nos nomes de campo de um pivot. 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 nomes de campo (nomes de dimensão) em todos os pivots precisa ser um subconjunto dos nomes de dimensão 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 das dimensões. As dimensões precisam ser solicitadas para serem usadas neste filtro. 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. As métricas precisam ser solicitadas para serem usadas neste filtro. Não é possível usar dimensões neste filtro.
currencyCode

string

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

object (CohortSpec)

Grupo de coorte associado a esta solicitação. Se houver um grupo de coorte na solicitação, a dimensão "cohort" vai 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.

Independentemente 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á uma linha eventName: "purchase" e eventCount: 0.
returnPropertyQuota

boolean

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

object (Comparison)

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