REST Resource: properties.reportTasks

Recurso: ReportTask

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

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 de um relatório. Ele normalmente 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 de relatório para uma tarefa de relatório específica, que fornece informações sobre um relatório. Ele geralmente inclui as seguintes informações: o nome do recurso, o estado e o carimbo de data/hora em que o relatório foi criado etc.

ReportDefinition

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

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 dos dados a serem lidos. Se vários períodos forem solicitados, cada linha da resposta conterá 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 precisa não ser especificado.

dimensionFilter

object (FilterExpression)

Opcional. Com os filtros de dimensão, você pode 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 do SQL. Não é possível usar dimensões neste filtro.

offset

string (int64 format)

Opcional. A contagem de linhas da linha inicial do armazenamento do Google Analytics. A primeira linha é contada como 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 que 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 poderia cobrir 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ê pedir. limit precisa ser positivo.

A API também poderá 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 somente sobre country, não é 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 de métricas agregados serão mostrados nas linhas em que dimensionValues estiverem definidos como "RESERVED_(MetricAggregate)".

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 vai 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, o campo "coort" a dimensão deve 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 dessa 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ão uma linha contendo eventName: "purchase" e eventCount: 0.

Dimensão

As dimensões são atributos dos seus dados. Por exemplo, a cidade da dimensão indica a cidade de origem de um evento. Os valores de dimensão nas respostas de 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

O 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 relatório, como runReport e batchRunReports. Consulte Dimensões em tempo real para 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 permitido. Por exemplo, se uma dimensionExpression concatenar country e city, você pode chamar essa dimensão 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 "país, cidade": concatenate(país, ", ", cidade).

DimensionExpression

Usado para expressar uma dimensão que é o resultado de uma fórmula com várias dimensões. Exemplos de uso: 1) bottomCase(dimension) 2) concatenar(dimension1, símbolo, 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 para letras minúsculas.

upperCase

object (CaseExpression)

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

concatenate

object (ConcatenateExpression)

Usado para combinar valores de dimensão em uma única dimensão. Por exemplo, dimensão "país, cidade": concatenate(país, ", ", cidade).

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 precisa se referir a um nome no campo de dimensões da solicitação.

ConcatenateExpression

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

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

string

São os nomes das dimensões. Os nomes precisam se referir aos nomes no campo de dimensões da solicitação.

delimiter

string

O delimitador colocado entre os nomes das dimensões.

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 = "US,FR", o valor da dimensão 2 = "JP" e o delimitador = ", a resposta vai conter "US,FR,JP".

Métrica

As medidas 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 ver 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 ver 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 permitido. Por exemplo, se expression for screenPageViews/sessions, o nome dessa métrica poderá ser viewsPerSession. Os nomes escolhidos precisam corresponder à expressão regular ^[a-zA-Z0-9_]$.

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

expression

string

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

invisible

boolean

Indica se uma métrica está invisível na resposta do relatório. Se uma métrica for invisível, ela não produzirá uma coluna na resposta, mas 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 são permitidas em 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. Os formatos NdaysAgo, yesterday ou today também são aceitos. Nesse caso, a data é inferida com base no fuso horário do relatório da propriedade.

endDate

string

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

name

string

Atribui um nome para o período. A dimensão dateRange é avaliada para esse nome em uma resposta de relatório. Se definido, não pode começar com date_range_ ou RESERVED_. Se a política não for definida, os períodos serão nomeados de acordo com o índice de base 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)

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

orGroup

object (FilterExpressionList)

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

notExpression

object (FilterExpression)

A FilterExpression NÃO é notExpression.

filter

object (Filter)

Um filtro primitivo. Na mesma FilterExpression, todos os nomes de campos 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.

Filtro

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 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 deste 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 da expressão regular com o valor da string.
PARTIAL_REGEXP Correspondência parcial para a 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 ficar em branco.

caseSensitive

boolean

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

NumericFilter

Filtros para valores numéricos ou de data.

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

enum (Operation)

O tipo de operação deste filtro.

value

object (NumericValue)

Um valor numérico ou de data.

Operação

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

Para 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 de um valor numérico one_value pode ser apenas um destes:
int64Value

string (int64 format)

Número inteiro

doubleValue

number

Valor duplo

BetweenFilter

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

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 define como as linhas serão classificadas na resposta. Por exemplo, ordenar linhas pela contagem de eventos decrescente é uma ordenação, 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étrica.

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 dos valores de dimensões.

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 minúsculo. Por exemplo, "2" < "A" < “b” < "X" < "z".
NUMERIC Os valores das dimensões são convertidos em números antes da classificação. Por exemplo, em classificação NUMERIC, "25" < "100" e na classificação ALPHANUMERIC, "100" < "25". Todos os valores de dimensão não numéricos têm o mesmo valor de ordenação 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 para a coorte. Por exemplo, é possível selecionar a coorte de usuários adquiridos na primeira semana de setembro e seguir 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. A coorte das próximas seis semanas é especificada no objeto cohortsRange.

Para exemplos, consulte Exemplos de relatórios de coorte.

A resposta do relatório pode mostrar uma série temporal semanal em que o 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 vão aparecer em 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 de coorte define apenas 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 as coortes durante um período de relatório estendido. Esse intervalo especifica uma duração de deslocamento para acompanhar as coortes.

cohortReportSettings

object (CohortReportSettings)

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

Coorte

Define um critério de seleção de 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 à coorte. A dimensão cohort é avaliada para esse nome em uma resposta de relatório. Se definido, não pode começar com cohort_ ou RESERVED_. Se não for definida, 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 a data do primeiro contato entre as datas de início e 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 pelo deslocamento presentes na cohortsRange. os dados de eventos para o período estendido de relatório estão presentes em um relatório de coorte.

Em uma solicitação de coorte, a dateRange é obrigatória, e o dateRanges na RunReportRequest ou na RunPivotReportRequest não pode ser especificado.

Esse dateRange geralmente precisa estar alinhado à granularidade da coorte. Se CohortsRange usar granularidade diária, esse 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 no período estendido de um relatório de coorte.

startOffset

integer

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

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 de relatório para um relatório de coorte. endOffset pode ser qualquer número inteiro positivo, mas normalmente é definido como 5 a 10 para que os relatórios contenham dados da 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 no período estendido de um relatório de coorte.

Enums
GRANULARITY_UNSPECIFIED Nunca deve ser especificado.
DAILY Granularidade diária. Usado normalmente se o dateRange da coorte for de um único dia e a solicitação contiver cohortNthDay.
WEEKLY Granularidade semanal. Usado com frequência se o dateRange da coorte tiver uma semana de duração (começando no domingo e terminando no sábado) e se a solicitação contiver cohortNthWeek.
MONTHLY Granularidade mensal. Usado normalmente se o dateRange da coorte tiver a duração de um mês 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 de relatório para uma tarefa de relatório 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 desse token será corrigida quando uma tarefa de relatório entrar no estado ACTIVE ou FAILED.

state

enum (State)

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

beginCreatingTime

string (Timestamp format)

Apenas saída. É a hora em que reportTasks.create foi chamado e o relatório começou 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. Esse campo será preenchido quando o estado estiver ativo. É possível utilizar taskRowCount para paginação nos limites do relatório existente.

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, ele poderá iniciar uma nova tarefa de relatório com base no totalRowCount.

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

Por exemplo, suponha que a taskRowCount do relatório atual seja 20 e exiba os dados das primeiras 20 linhas. Ao mesmo tempo, o totalRowCount é 30, indicando a presença de dados para todas 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 30 linhas de dados em grande quantidade.

Estado

O estado de processamento.

Enums
STATE_UNSPECIFIED Um estado não especificado nunca será usado.
CREATING O relatório está sendo criado e vai estar disponível no futuro. A criação ocorre imediatamente após a chamada CreateReport.
ACTIVE O relatório foi criado e está pronto para consultas.
FAILED Não foi possível criar o relatório.

Métodos

create

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

get

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

list

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

query

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