REST Resource: properties.reportTasks

Recurso: ReportTask

A configuração de uma tarefa de relatório específica.

Representação JSON
{
  "name": string,
  "reportDefinition": {
    object (ReportDefinition)
  },
  "reportMetadata": {
    object (ReportMetadata)
  }
}
Campos
name

string

Apenas saída. Identificador. O nome do recurso da tarefa de relatório atribuído durante a criação. Formato: "properties/{property}/reportTasks/{reportTask}"

reportDefinition

object (ReportDefinition)

Opcional. Uma definição de relatório para buscar dados de relatório, que descreve a estrutura dele. Essa métrica geralmente inclui os campos que serão incluídos no relatório e os critérios que serão usados para filtrar os dados.

reportMetadata

object (ReportMetadata)

Apenas saída. Os metadados do relatório de uma tarefa específica, que fornecem informações sobre um relatório. Ela normalmente inclui as seguintes informações: o nome do recurso, o estado, o carimbo de data/hora em que o relatório foi criado etc.

ReportDefinition

A definição de como um relatório deve ser gerado.

Representação JSON
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "offset": string,
  "limit": string,
  "metricAggregations": [
    enum (MetricAggregation)
  ],
  "orderBys": [
    {
      object (OrderBy)
    }
  ],
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean
}
Campos
dimensions[]

object (Dimension)

Opcional. As dimensões solicitadas e exibidas.

metrics[]

object (Metric)

Opcional. As métricas solicitadas e exibidas.

dateRanges[]

object (DateRange)

Opcional. Períodos de dados a serem lidos. Se vários períodos forem solicitados, cada linha de resposta terá um índice de período baseado em zero. Se dois períodos se sobrepuserem, os dados de eventos dos dias sobrepostos serão incluídos nas linhas de resposta dos dois períodos. Em uma solicitação de coorte, esse dateRanges não pode ser especificado.

dimensionFilter

object (FilterExpression)

Opcional. Com os filtros de dimensão, é possível solicitar somente valores de dimensão específicos no relatório. Para saber mais, consulte Princípios básicos dos filtros de dimensão para ver exemplos. Não é possível usar métricas neste filtro.

metricFilter

object (FilterExpression)

Opcional. A cláusula de filtro das métricas. Aplicado após agregar as linhas do relatório, semelhante à cláusula SQL. Não é possível usar dimensões neste filtro.

offset

string (int64 format)

Opcional. A contagem de linhas da primeira linha do armazenamento do Google Analytics. A primeira linha é contada como a linha 0.

Ao criar uma tarefa de relatório, os parâmetros offset e limit definem o subconjunto de linhas de dados do armazenamento do Google Analytics a ser incluído no relatório gerado. Por exemplo, se houver um total de 300.000 linhas no armazenamento do Google Analytics, a tarefa de relatório inicial poderá ter as primeiras 10.000 linhas com um limite de 10.000 e um deslocamento de 0. Posteriormente, outra tarefa de relatório pode abranger as próximas 10.000 linhas com um limite de 10.000 e um deslocamento de 10.000.

limit

string (int64 format)

Opcional. O número de linhas a serem retornadas no relatório. Se não for especificado, 10.000 linhas serão retornadas. A API retorna no máximo 250.000 linhas por solicitação, independentemente de quantas linhas 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 um relatório somente para country, não será possível gerar mais de 300 linhas, mesmo que você defina limit como um valor mais alto.

metricAggregations[]

enum (MetricAggregation)

Opcional. Agregação de métricas. Os valores das métricas agregadas serão mostrados nas linhas em que "dimensionValues" estiver definido como "RESERVED_(Metric separadamente)".

orderBys[]

object (OrderBy)

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

currencyCode

string

Opcional. 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)

Opcional. 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

Opcional. 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 da configuração de keepEmptyRows, somente os dados registrados pela propriedade do Google Analytics (GA4) podem ser exibidos 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 contendo eventName: "purchase" e eventCount: 0.

Dimensão

As dimensões são atributos dos seus dados. Por exemplo, a dimensão "cidade" indica a cidade de origem de um evento. Os valores de dimensão nas respostas do relatório são strings. Por exemplo, a cidade poderia ser "Paris" ou "Nova York".

Representação JSON
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
Campos
name

string

Nome da dimensão. Consulte as Dimensões da API para ver a lista de nomes de dimensões compatíveis com os principais métodos de geração de relatórios, como runReport e batchRunReports. Consulte Dimensões em tempo real para ver a lista de nomes de dimensões compatíveis com o método runRealtimeReport. Consulte Dimensões do funil para ver a lista de nomes de dimensões compatíveis com o método runFunnelReport.

Se dimensionExpression for especificado, name poderá ser qualquer string que você quiser dentro do conjunto de caracteres permitidos. Por exemplo, se um dimensionExpression concatenar country e city, essa dimensão poderá ser chamada de countryAndCity. Os nomes de dimensões escolhidos precisam corresponder à expressão regular ^[a-zA-Z0-9_]$.

As dimensões são referenciadas por name em dimensionFilter, orderBys, dimensionExpression e pivots.

dimensionExpression

object (DimensionExpression)

Uma dimensão pode ser o resultado de uma expressão de várias dimensões. Por exemplo, dimensão "country, city": concatenate(country, ", ", city).

DimensionExpression

Usado para expressar uma dimensão que é o resultado de uma fórmula de várias dimensões. Exemplos de uso: 1) lowerCase(dimension) 2) concatenate(dimension1, Symbol, dimension2).

Representação JSON
{

  // Union field one_expression can be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union field one_expression.
}
Campos
Campo de união one_expression. Especifique um tipo de expressão de dimensão para DimensionExpression. one_expression pode ser apenas de um dos tipos a seguir:
lowerCase

object (CaseExpression)

Usado para converter um valor de dimensão em minúsculas.

upperCase

object (CaseExpression)

Usado para converter um valor de dimensão em maiúsculas.

concatenate

object (ConcatenateExpression)

Usado para combinar valores de dimensão a uma única dimensão. Por exemplo, dimensão "country, city": concatenate(country, ", ", city).

CaseExpression

Usado para converter um valor de dimensão em um único caso.

Representação JSON
{
  "dimensionName": string
}
Campos
dimensionName

string

Nome de uma dimensão. O nome deve se referir a um nome no campo de dimensões da solicitação.

ConcatenateExpression

Usado para combinar valores de dimensão a uma única dimensão.

Representação JSON
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
Campos
dimensionNames[]

string

Nomes de dimensões. Os nomes devem se referir aos nomes no campo de dimensões da solicitação.

delimiter

string

O delimitador colocado entre os nomes da dimensão.

Os delimitadores geralmente são caracteres únicos, como "|" ou ",", mas podem ser strings mais longas. Se um valor de dimensão tiver o delimitador, ambos estarão presentes na resposta sem distinção. Por exemplo, se o valor da dimensão 1 for "US,FR", o valor da dimensão 2 for "JP" e o delimitador = ", a resposta vai conter "US,FR,JP".

Métrica

As medições quantitativas de um relatório. Por exemplo, a métrica eventCount é o número total de eventos. As solicitações podem ter até 10 métricas.

Representação JSON
{
  "name": string,
  "expression": string,
  "invisible": boolean
}
Campos
name

string

O nome da métrica. Consulte as Métricas da API para acessar a lista de nomes de métricas compatíveis com os principais métodos de geração de relatórios, como runReport e batchRunReports. Consulte Métricas em tempo real para ver a lista de nomes de métricas compatíveis com o método runRealtimeReport. Consulte Métricas de funil para acessar a lista de nomes de métricas compatíveis com o método runFunnelReport.

Se expression for especificado, name poderá ser qualquer string que você quiser dentro do conjunto de caracteres permitidos. Por exemplo, se expression for screenPageViews/sessions, o nome dessa métrica poderá ser viewsPerSession. Os nomes das métricas escolhidos precisam corresponder à expressão regular ^[a-zA-Z0-9_]$.

As métricas são referenciadas por name em metricFilter, orderBys e por expression.

expression

string

Uma expressão matemática para métricas derivadas. Por exemplo, a métrica "Contagem de eventos" por usuário é eventCount/totalUsers.

invisible

boolean

Indica se uma métrica está invisível na resposta do relatório. Se uma métrica estiver invisível, ela não vai produzir uma coluna na resposta, mas vai poder ser usada em metricFilter, orderBys ou em uma métrica expression.

DateRange

Um conjunto contíguo de dias: startDate, startDate + 1, ..., endDate. As solicitações podem ter até quatro períodos.

Representação JSON
{
  "startDate": string,
  "endDate": string,
  "name": string
}
Campos
startDate

string

A data de início inclusiva para a consulta no formato YYYY-MM-DD. Não pode ser depois de endDate. O formato NdaysAgo, yesterday ou today também é aceito. Nesse caso, a data é inferida com base no fuso horário do relatório da propriedade.

endDate

string

A data de término inclusiva da consulta no formato YYYY-MM-DD. Não pode ser anterior a startDate. O formato NdaysAgo, yesterday ou today também é aceito. Nesse caso, a data é inferida com base no fuso horário do relatório da propriedade.

name

string

Atribui um nome ao período. A dimensão dateRange é avaliada com esse nome em uma resposta de relatório. Se definido, não pode começar com date_range_ ou RESERVED_. Se não for definido, os períodos serão nomeados de acordo com o índice baseado em zero na solicitação: date_range_0, date_range_1 etc.

FilterExpression

Para expressar filtros de dimensão ou métrica. Os campos na mesma FilterExpression precisam ter todas as dimensões ou todas as métricas.

Representação JSON
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FilterExpressionList)
  },
  "orGroup": {
    object (FilterExpressionList)
  },
  "notExpression": {
    object (FilterExpression)
  },
  "filter": {
    object (Filter)
  }
  // End of list of possible types for union field expr.
}
Campos
Campo de união expr. Especifique um tipo de expressão de filtro para FilterExpression. expr pode ser apenas de um dos tipos a seguir:
andGroup

object (FilterExpressionList)

Os FilterExpressions em andGroup têm uma relação AND.

orGroup

object (FilterExpressionList)

Os FilterExpressions em orGroup têm uma relação OR.

notExpression

object (FilterExpression)

FilterExpression NÃO é de notExpression.

filter

object (Filter)

Um filtro primitivo. Na mesma FilterExpression, todos os nomes de campo do filtro precisam ser todas as dimensões ou todas as métricas.

FilterExpressionList

Uma lista de expressões de filtro.

Representação JSON
{
  "expressions": [
    {
      object (FilterExpression)
    }
  ]
}
Campos
expressions[]

object (FilterExpression)

Uma lista de expressões de filtro.

Filtrar

Uma expressão para filtrar valores de dimensão ou métrica.

Representação JSON
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Campos
fieldName

string

O nome da dimensão ou da métrica. Precisa ser um nome definido nas dimensões ou métricas.

Campo de união one_filter. Especifique um tipo de filtro para Filter. one_filter pode ser apenas de um dos tipos a seguir:
stringFilter

object (StringFilter)

Filtro relacionado a strings.

inListFilter

object (InListFilter)

Um filtro para valores na lista.

numericFilter

object (NumericFilter)

Um filtro para valores numéricos ou de data.

betweenFilter

object (BetweenFilter)

Um filtro para entre dois valores.

StringFilter

O filtro para string

Representação JSON
{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}
Campos
matchType

enum (MatchType)

O tipo de correspondência para este filtro.

value

string

O valor da string usado para a correspondência.

caseSensitive

boolean

Se verdadeiro, o valor da string diferencia maiúsculas de minúsculas.

MatchType

O tipo de correspondência de um filtro de string

Enums
MATCH_TYPE_UNSPECIFIED Não especificado
EXACT Correspondência exata do valor da string.
BEGINS_WITH Começa com o valor da string.
ENDS_WITH Termina com o valor da string.
CONTAINS Contém o valor da string.
FULL_REGEXP Correspondência total para a expressão regular com o valor da string.
PARTIAL_REGEXP Correspondência parcial da expressão regular com o valor da string.

InListFilter

O resultado precisa estar em uma lista de valores de string.

Representação JSON
{
  "values": [
    string
  ],
  "caseSensitive": boolean
}
Campos
values[]

string

A lista de valores de string. Não pode estar em branco.

caseSensitive

boolean

Se verdadeiro, o valor da string diferencia maiúsculas de minúsculas.

NumericFilter

Filtra os valores numéricos ou de data.

Representação JSON
{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}
Campos
operation

enum (Operation)

O tipo de operação para este filtro.

value

object (NumericValue)

Um valor numérico ou um valor de data.

Operação

A operação aplicada a um filtro numérico

Enums
OPERATION_UNSPECIFIED Não especificado.
EQUAL Igual
LESS_THAN Menor que
LESS_THAN_OR_EQUAL menor ou igual a
GREATER_THAN maior que
GREATER_THAN_OR_EQUAL maior ou igual a

NumericValue

Representar um número.

Representação JSON
{

  // Union field one_value can be only one of the following:
  "int64Value": string,
  "doubleValue": number
  // End of list of possible types for union field one_value.
}
Campos
Campo de união one_value. Um dos valores numéricos one_value pode ser apenas uma das seguintes opções:
int64Value

string (int64 format)

Número inteiro

doubleValue

number

Valor duplo

BetweenFilter

Para expressar que o resultado precisa estar entre dois números (inclusive).

Representação JSON
{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}
Campos
fromValue

object (NumericValue)

Começa com este número.

toValue

object (NumericValue)

Termina com este número.

MetricAggregation

Representa a agregação de métricas.

Enums
METRIC_AGGREGATION_UNSPECIFIED Operador não especificado.
TOTAL Operador SUM.
MINIMUM Operador mínimo.
MAXIMUM Operador máximo.
COUNT Operador de contagem.

OrderBy

A ordenação por define como as linhas serão classificadas na resposta. Por exemplo, ordenar linhas pela contagem de eventos decrescentes é uma ordem, e ordenar linhas pela string do nome do evento é uma ordem diferente.

Representação JSON
{
  "desc": boolean,

  // Union field one_order_by can be only one of the following:
  "metric": {
    object (MetricOrderBy)
  },
  "dimension": {
    object (DimensionOrderBy)
  }
  // End of list of possible types for union field one_order_by.
}
Campos
desc

boolean

Se verdadeiro, classifica por ordem decrescente.

Campo de união one_order_by. Especifique um tipo de ordem por para OrderBy. one_order_by pode ser apenas de um dos tipos a seguir:
metric

object (MetricOrderBy)

Classifica os resultados pelos valores de uma métrica.

dimension

object (DimensionOrderBy)

Classifica os resultados pelos valores de uma dimensão.

MetricOrderBy

Classifica por valores de métricas.

Representação JSON
{
  "metricName": string
}
Campos
metricName

string

Um nome de métrica na solicitação para ordenar.

DimensionOrderBy

Classifica por valores de dimensão.

Representação JSON
{
  "dimensionName": string,
  "orderType": enum (OrderType)
}
Campos
dimensionName

string

Um nome de dimensão na solicitação para ordenar.

orderType

enum (OrderType)

Controla a regra de ordenação de valores de dimensão.

OrderType

Regra para ordenar os valores de dimensão da string.

Enums
ORDER_TYPE_UNSPECIFIED Não especificado.
ALPHANUMERIC Classificação alfanumérica por ponto de código Unicode. Por exemplo, "2" < "A" < "X" < "b" < "z".
CASE_INSENSITIVE_ALPHANUMERIC Classificação alfanumérica sem distinção entre maiúsculas e minúsculas por ponto de código Unicode em minúsculas. Por exemplo, "2" < "A" < "b" < "X" < "z".
NUMERIC Os valores de dimensão são convertidos em números antes da classificação. Por exemplo, na classificação NUMERIC, "25" < "100" e na classificação ALPHANUMERIC, "100" < "25". Todos os valores de dimensão não numéricos têm um valor de ordem igual abaixo de todos os valores numéricos.

CohortSpec

A especificação de coortes para um relatório de coorte.

Os relatórios de coorte criam uma série temporal de retenção de usuários. Por exemplo, é possível selecionar a coorte de usuários que foram adquiridos na primeira semana de setembro e acompanhar essa coorte pelas próximas seis semanas. A seleção dos usuários adquiridos na primeira semana da coorte de setembro é especificada no objeto cohort. O acompanhamento dessa coorte pelas próximas seis semanas é especificado no objeto cohortsRange.

Para ver exemplos, consulte Exemplos de Relatório de coorte.

A resposta do relatório pode mostrar uma série temporal semanal em que digamos que seu app reteve 60% da coorte após três semanas e 25% após seis semanas. Essas duas porcentagens podem ser calculadas pela métrica cohortActiveUsers/cohortTotalUsers e serão linhas separadas no relatório.

Representação JSON
{
  "cohorts": [
    {
      object (Cohort)
    }
  ],
  "cohortsRange": {
    object (CohortsRange)
  },
  "cohortReportSettings": {
    object (CohortReportSettings)
  }
}
Campos
cohorts[]

object (Cohort)

Define os critérios de seleção para agrupar usuários em coortes.

A maioria dos relatórios define somente uma única coorte. Se várias coortes forem especificadas, cada uma delas poderá ser reconhecida no relatório pelo nome.

cohortsRange

object (CohortsRange)

Os relatórios de coorte seguem coortes para um período estendido de relatório. Esse intervalo especifica uma duração de deslocamento para seguir as coortes.

cohortReportSettings

object (CohortReportSettings)

Configurações opcionais para um relatório de coorte.

Coorte

Define os critérios de seleção de uma coorte. Um coorte é um grupo de usuários que compartilham uma característica comum. Por exemplo, usuários com o mesmo firstSessionDate pertencem à mesma coorte.

Representação JSON
{
  "name": string,
  "dimension": string,
  "dateRange": {
    object (DateRange)
  }
}
Campos
name

string

Atribui um nome a essa coorte. A dimensão cohort é avaliada com esse nome em uma resposta de relatório. Se definido, não pode começar com cohort_ ou RESERVED_. Se não for definido, as coortes serão nomeadas pelo índice baseado em zero cohort_0, cohort_1 etc.

dimension

string

Dimensão usada pela coorte. Obrigatório e compatível apenas com firstSessionDate.

dateRange

object (DateRange)

A coorte seleciona usuários que tiveram o primeiro contato entre a data de início e de término definidas no dateRange. Esse dateRange não especifica o período completo dos dados de eventos presentes em um relatório de coorte. Em um relatório de coorte, esse dateRange é estendido pela granularidade e deslocamento presentes em cohortsRange. Os dados de evento do período estendido do relatório estão presentes em um relatório de coorte.

Em uma solicitação de coorte, esse dateRange é obrigatório, e o dateRanges no RunReportRequest ou no RunPivotReportRequest não pode ser especificado.

Em geral, esse dateRange precisa estar alinhado à granularidade da coorte. Se CohortsRange usar a granularidade diária, essa dateRange poderá ser um único dia. Se CohortsRange usar granularidade semanal, esse dateRange poderá ser alinhado a um limite de semana, começando no domingo e terminando no sábado. Se CohortsRange usar granularidade mensal, esse dateRange poderá ser alinhado a um mês, começando no primeiro e terminando no último dia do mês.

CohortsRange

Configura o período estendido de um relatório de coorte. Especifica uma duração de deslocamento para seguir as coortes.

Representação JSON
{
  "granularity": enum (Granularity),
  "startOffset": integer,
  "endOffset": integer
}
Campos
granularity

enum (Granularity)

Obrigatório. A granularidade usada para interpretar startOffset e endOffset para o período estendido de um relatório de coorte.

startOffset

integer

startOffset especifica a data de início do período estendido do relatório de um relatório de coorte. startOffset geralmente é definido como 0 para que os relatórios contenham dados da aquisição da coorte em diante.

Se granularity for DAILY, o startDate do período estendido do relatório será startDate da coorte mais startOffset dias.

Se granularity for WEEKLY, o startDate do período estendido do relatório será startDate da coorte mais startOffset * 7 dias.

Se granularity for MONTHLY, o startDate do período estendido do relatório será startDate da coorte mais startOffset * 30 dias.

endOffset

integer

Obrigatório. endOffset especifica a data de término do período estendido do relatório de um relatório de coorte. endOffset pode ser qualquer número inteiro positivo, mas geralmente é definido como 5 a 10 para que os relatórios contenham dados sobre a coorte para os próximos períodos de granularidade.

Se granularity for DAILY, o endDate do período estendido do relatório será endDate da coorte mais endOffset dias.

Se granularity for WEEKLY, o endDate do período estendido do relatório será endDate da coorte mais endOffset * 7 dias.

Se granularity for MONTHLY, o endDate do período estendido do relatório será endDate da coorte mais endOffset * 30 dias.

Granularidade

A granularidade usada para interpretar startOffset e endOffset para o período estendido de um relatório de coorte.

Enums
GRANULARITY_UNSPECIFIED Nunca deve ser especificado.
DAILY Granularidade diária. Geralmente usado se o dateRange da coorte for um único dia e a solicitação contiver cohortNthDay.
WEEKLY Granularidade semanal. Usado normalmente se a dateRange da coorte tiver uma semana de duração (começando no domingo e terminando no sábado) e a solicitação contém cohortNthWeek.
MONTHLY Granularidade mensal. Usado normalmente se o dateRange da coorte tiver um mês de duração e a solicitação contiver cohortNthMonth.

CohortReportSettings

Configurações opcionais de um relatório de coorte.

Representação JSON
{
  "accumulate": boolean
}
Campos
accumulate

boolean

Se verdadeiro, acumula o resultado do primeiro dia de contato até o dia de término. Indisponível em RunReportRequest.

ReportMetadata

Os metadados do relatório de uma tarefa específica.

Representação JSON
{
  "creationQuotaTokensCharged": integer,
  "state": enum (State),
  "beginCreatingTime": string,
  "taskRowCount": integer,
  "errorMessage": string,
  "totalRowCount": integer
}
Campos
creationQuotaTokensCharged

integer

Apenas saída. O total de tokens de cota cobrados durante a criação do relatório. Como essa contagem de tokens é baseada na atividade do estado CREATING, a cobrança de tokens será corrigida quando uma tarefa de relatório entrar no estado ACTIVE ou FAILED.

state

enum (State)

Apenas saída. O estado atual desta tarefa de relatório.

beginCreatingTime

string (Timestamp format)

Apenas saída. A hora em que reportTasks.create foi chamado e o relatório iniciou o estado CREATING.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

taskRowCount

integer

Apenas saída. O número total de linhas no resultado do relatório. Este campo será preenchido quando o estado estiver ativo. Você pode usar taskRowCount para paginação dentro dos limites do relatório atual.

errorMessage

string

Apenas saída. A mensagem de erro será preenchida se uma tarefa de relatório falhar durante a criação.

totalRowCount

integer

Apenas saída. O número total de linhas no armazenamento do Google Analytics. Se você quiser consultar outras linhas de dados além do relatório atual, elas poderão iniciar uma nova tarefa de relatório com base no totalRowCount.

O taskRowCount representa o número de linhas pertencentes especificamente ao relatório atual, enquanto totalRowCount engloba a contagem total de linhas em todos os dados recuperados do armazenamento do Google Analytics.

Por exemplo, suponha que o taskRowCount do relatório atual seja 20, exibindo os dados das 20 primeiras linhas. Ao mesmo tempo, a totalRowCount é 30, indicando a presença de dados para as 30 linhas. O taskRowCount pode ser usado para paginar as 20 linhas iniciais. Para expandir o relatório e incluir dados de todas as 30 linhas, uma nova tarefa de relatório pode ser criada usando totalRowCount para acessar o conjunto completo de dados de 30 linhas.

Estado

O estado de processamento.

Enums
STATE_UNSPECIFIED Um estado não especificado nunca será usado.
CREATING O relatório está sendo criado e será disponibilizado no futuro. A criação ocorre imediatamente após a chamada CreateReport.
ACTIVE O relatório está totalmente criado e pronto para consulta.
FAILED Falha ao criar o relatório.

Métodos

create

Inicia a criação de uma tarefa de relatório.

get

Recebe os metadados do relatório sobre uma tarefa específica.

list

Lista todas as tarefas de relatório de uma propriedade.

query

Recupera o conteúdo de uma tarefa de relatório.