REST Resource: properties.reportTasks

{
  "name": string,
  "reportDefinition": {
    object (ReportDefinition)
  },
  "reportMetadata": {
    object (ReportMetadata)
  }
}

string

Solo salida. Identificador. El nombre del recurso de la tarea de informes asignado durante la creación. Formato: “properties/{property}/reportTasks/{reportTask}”

object (ReportDefinition)

Opcional. Definición de informe para recuperar datos de un informe, que describe la estructura de un informe. Suele incluir los campos que se incluirán en el informe y los criterios que se utilizarán para filtrar los datos.

object (ReportMetadata)

Solo salida. Los metadatos de informe para una tarea específica de informe, que proporcionan información sobre un informe. Por lo general, incluye la siguiente información: el nombre del recurso del informe, el estado del informe, la marca de tiempo en la que se creó el informe, etcétera.

{
  "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
}

object (Dimension)

Opcional. Son las dimensiones solicitadas y que se muestran.

object (Metric)

Opcional. Las métricas solicitadas y que se muestran.

object (DateRange)

Opcional. Períodos de los datos que se leerán. Si se solicitan varios períodos, cada fila de respuesta contendrá un índice de período basado en cero. Si dos períodos se superponen, los datos de eventos de los días superpuestos se incluyen en las filas de respuesta de ambos períodos. En una solicitud de cohorte, no se debe especificar este dateRanges.

object (FilterExpression)

Opcional. Los filtros de dimensiones te permiten solicitar solo valores de dimensión específicos en el informe. Si deseas obtener más información, consulta ejemplos del artículo Aspectos básicos de los filtros de dimensión. No se pueden usar métricas en este filtro.

object (FilterExpression)

Opcional. La cláusula de filtro de las métricas. Se aplica después de agregar las filas del informe, de manera similar a la cláusula de cláusula de SQL. No se pueden usar dimensiones en este filtro.

string (int64 format)

Opcional. El recuento de filas de la fila de inicio del almacenamiento de Google Analytics. La primera fila se cuenta como la fila 0.

Cuando se crea una tarea de informe, los parámetros offset y limit definen el subconjunto de filas de datos del almacenamiento de Google Analytics que se incluirán en el informe generado. Por ejemplo, si hay un total de 300,000 filas en el almacenamiento de Google Analytics, la tarea de informe inicial puede tener las primeras 10,000 filas con un límite de 10,000 y un desplazamiento de 0. Posteriormente, otra tarea de informe podría cubrir las siguientes 10,000 filas con un límite de 10,000 y un desplazamiento de 10,000.

string (int64 format)

Opcional. Es la cantidad de filas que se mostrarán en el informe. Si no se especifica, se muestran 10,000 filas. La API devuelve un máximo de 250,000 filas por solicitud, sin importar cuántas tengas. limit debe ser positivo.

La API también puede mostrar menos filas que la limit solicitada si no hay tantos valores de dimensión como la limit. Por ejemplo, hay menos de 300 valores posibles para la dimensión country. Por lo tanto, si genera informes solo de country, no podrá obtener más de 300 filas, incluso si establece limit en un valor más alto.

enum (MetricAggregation)

Opcional. Agregación de métricas. Los valores de métricas agregados se mostrarán en las filas en las que dimensionValues se configuren como "RESERVED_(MetricAggregation)".

object (OrderBy)

Opcional. Especifica cómo se ordenan las filas en la respuesta.

string

Opcional. Un código de moneda en formato ISO4217, como “AED”, “USD” o “JPY”. Si el campo está vacío, el informe utilizará la moneda predeterminada de la propiedad.

object (CohortSpec)

Opcional. Grupo de cohorte asociado con esta solicitud. Si hay un grupo de cohorte en la solicitud, la dimensión "cohorte" debe estar presente.

boolean

Opcional. Si es falso o no se especifica, no se mostrará cada fila con todas las métricas iguales a 0. Si es verdadero, estas filas se mostrarán si un filtro no las quita por separado.

Independientemente de este parámetro de configuración de keepEmptyRows, solo se pueden mostrar en un informe los datos registrados por la propiedad de Google Analytics (GA4).

Por ejemplo, si una propiedad nunca registra un evento purchase, una consulta sobre la dimensión eventName y la métrica eventCount no tendrá una fila que contenga eventName: "purchase" y eventCount: 0.

{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}

string

Es el nombre de la dimensión. Consulta la sección Dimensiones de la API para obtener la lista de los nombres de las dimensiones compatibles con los principales métodos de informes, como runReport y batchRunReports. Consulta Dimensiones en tiempo real para obtener la lista de nombres de dimensiones compatibles con el método runRealtimeReport. Consulta Dimensiones del embudo para obtener la lista de nombres de dimensiones compatibles con el método runFunnelReport.

Si se especifica dimensionExpression, name puede ser cualquier cadena que desees dentro del grupo de caracteres permitido. Por ejemplo, si una dimensionExpression concatena country y city, puedes llamar a esa dimensión countryAndCity. Los nombres de las dimensiones que elijas deben coincidir con la expresión regular ^[a-zA-Z0-9_]$.

name hace referencia a las dimensiones en dimensionFilter, orderBys, dimensionExpression y pivots.

object (DimensionExpression)

Una dimensión puede ser el resultado de una expresión de varias dimensiones. Por ejemplo, dimensión "país, ciudad": concatenar(país, ", ", ciudad).

{

  // 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.
}

object (CaseExpression)

Se utiliza para convertir el valor de una dimensión a minúsculas.

object (CaseExpression)

Se utiliza para convertir el valor de una dimensión en mayúsculas.

object (ConcatenateExpression)

Se utiliza para combinar valores de dimensión en una sola dimensión. Por ejemplo, dimensión "país, ciudad": concatenar(país, ", ", ciudad).

{
  "dimensionName": string
}

string

Es el nombre de una dimensión. El nombre debe hacer referencia a un nombre en el campo de dimensiones de la solicitud.

{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}

string

Son los nombres de las dimensiones. Los nombres deben referirse a los nombres en el campo de dimensiones de la solicitud.

string

El delimitador ubicado entre los nombres de las dimensiones.

Los delimitadores suelen ser caracteres únicos, como "|" o ",", pero pueden ser cadenas más largas. Si un valor de dimensión contiene el delimitador, ambos estarán presentes en respuesta sin distinción. Por ejemplo,si el valor de la dimensión 1 = "US,FR", el valor de dimensión 2 = "JP" y el delimitador = ",", la respuesta contendrá "US,FR,JP".

{
  "name": string,
  "expression": string,
  "invisible": boolean
}

string

Es el nombre de la métrica. Consulta Métricas de API para obtener la lista de nombres de métricas compatibles con los principales métodos de informes, como runReport y batchRunReports. Consulta Métricas en tiempo real para obtener la lista de nombres de métricas compatibles con el método runRealtimeReport. Consulta Métricas de embudo para obtener la lista de nombres de métricas compatibles con el método runFunnelReport.

Si se especifica expression, name puede ser cualquier cadena que desees dentro del grupo de caracteres permitido. Por ejemplo, si expression es screenPageViews/sessions, podrías llamar al nombre de esa métrica = viewsPerSession. Los nombres de las métricas que elijas deben coincidir con la expresión regular ^[a-zA-Z0-9_]$.

name hace referencia a las métricas en metricFilter, orderBys y expression.

string

Una expresión matemática para métricas derivadas. Por ejemplo, la métrica Recuento de eventos por usuario es eventCount/totalUsers.

boolean

Indica si una métrica es invisible en la respuesta del informe. Si una métrica es invisible, no generará una columna en la respuesta, pero se puede usar en metricFilter, orderBys o expression.

{
  "startDate": string,
  "endDate": string,
  "name": string
}

string

La fecha de inicio inclusiva de la consulta en el formato YYYY-MM-DD. No puede ser posterior a endDate. También se acepta el formato NdaysAgo, yesterday o today. En ese caso, la fecha se infiere en función de la zona horaria del informe de la propiedad.

string

La fecha de finalización inclusiva de la consulta en el formato YYYY-MM-DD. No puede ser anterior a startDate. También se acepta el formato NdaysAgo, yesterday o today. En ese caso, la fecha se infiere en función de la zona horaria del informe de la propiedad.

string

Asigna un nombre a este período. La dimensión dateRange se asigna a este nombre en una respuesta de informe. Si se configura, no puede comenzar con date_range_ ni RESERVED_. Si no se establece, los períodos se nombran con su índice basado en cero en la solicitud: date_range_0, date_range_1, etcétera.

{

  // 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.
}

object (FilterExpressionList)

Las FilterExpressions en andGroup tienen una relación de AND.

object (FilterExpressionList)

Las FilterExpressions en orGroup tienen una relación de OR.

object (FilterExpression)

FilterExpression NO es notExpression.

object (Filter)

Un filtro primitivo En la misma FilterExpression, todos los nombres de campo del filtro deben ser todas las dimensiones o todas las métricas.

{
  "expressions": [
    {
      object (FilterExpression)
    }
  ]
}

object (FilterExpression)

Una lista de expresiones de filtro.

{
  "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.
}

string

El nombre de la dimensión o la métrica. Debe ser un nombre definido en dimensiones o métricas.

object (StringFilter)

Filtro relacionado con strings.

object (InListFilter)

Un filtro para los valores en la lista.

object (NumericFilter)

Un filtro para valores numéricos o de fecha.

object (BetweenFilter)

Es un filtro para entre dos valores.

{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}

enum (MatchType)

El tipo de concordancia de este filtro.

string

El valor de string que se usa para la coincidencia.

boolean

Si es verdadero, el valor de la string distingue mayúsculas de minúsculas.

{
  "values": [
    string
  ],
  "caseSensitive": boolean
}

string

La lista de valores de cadena. Este campo no puede estar vacío.

boolean

Si es verdadero, el valor de la string distingue mayúsculas de minúsculas.

{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}

enum (Operation)

El tipo de operación de este filtro.

object (NumericValue)

Es un valor numérico o de fecha.

{

  // 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.
}

string (int64 format)

Valor del número entero

number

Valor doble

{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}

object (NumericValue)

Comienza con este número.

object (NumericValue)

Termina con este número.

{
  "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.
}

boolean

Si el valor es verdadero, se ordena por orden descendente.

object (MetricOrderBy)

Ordena los resultados según los valores de una métrica.

object (DimensionOrderBy)

Ordena los resultados según los valores de una dimensión.

{
  "metricName": string
}

string

Un nombre de métrica en la solicitud para ordenar.

{
  "dimensionName": string,
  "orderType": enum (OrderType)
}

string

Un nombre de dimensión en la solicitud para ordenar.

enum (OrderType)

Controla la regla para el orden de los valores de dimensión.

{
  "cohorts": [
    {
      object (Cohort)
    }
  ],
  "cohortsRange": {
    object (CohortsRange)
  },
  "cohortReportSettings": {
    object (CohortReportSettings)
  }
}

object (Cohort)

Define los criterios de selección para agrupar usuarios en cohortes.

La mayoría de los informes de cohorte definen una sola cohorte. Si se especifican varias cohortes, cada una se puede reconocer en el informe por su nombre.

object (CohortsRange)

Los informes de cohorte siguen cohortes durante un período de informe extendido. Este rango especifica una duración de desplazamiento para seguir a las cohortes.

object (CohortReportSettings)

Configuración opcional para un informe de cohorte.

{
  "name": string,
  "dimension": string,
  "dateRange": {
    object (DateRange)
  }
}

string

Asigna un nombre a esta cohorte. La dimensión cohort se asigna a este nombre en una respuesta de informe. Si se configura, no puede comenzar con cohort_ ni RESERVED_. Si no se establece, las cohortes se nombran con su índice basado en cero cohort_0, cohort_1, etcétera.

string

Dimensión que usa la cohorte. Obligatorio y solo admite firstSessionDate.

object (DateRange)

La cohorte selecciona a los usuarios cuya fecha de primer contacto se encuentra entre la fecha de inicio y la fecha de finalización definidas en dateRange. Este dateRange no especifica el período completo de datos de eventos que están presentes en un informe de cohorte. En un informe de cohorte, esta dateRange se extiende por el nivel de detalle y la compensación presentes en el cohortsRange. Los datos de eventos para el período extendido del informe están presentes en un informe de cohorte.

En una solicitud de cohorte, este dateRange es obligatorio y no se debe especificar el dateRanges en RunReportRequest o RunPivotReportRequest.

Por lo general, este dateRange debe estar alineado con el nivel de detalle de la cohorte. Si CohortsRange usa el nivel de detalle diario, este dateRange puede ser un solo día. Si CohortsRange usa un nivel de detalle semanal, este dateRange se puede alinear con un límite de semana, desde el domingo hasta el sábado. Si CohortsRange usa el nivel de detalle mensual, este dateRange se puede alinear con un mes, comenzando en el primer día y finalizando el último día del mes.

{
  "granularity": enum (Granularity),
  "startOffset": integer,
  "endOffset": integer
}

enum (Granularity)

Obligatorio. Es el nivel de detalle que se usa para interpretar los valores de startOffset y endOffset del período extendido del informe de un informe de cohorte.

integer

startOffset especifica la fecha de inicio del período extendido del informe para un informe de cohorte. startOffset suele establecerse en 0 para que los informes contengan datos desde la adquisición de la cohorte en adelante.

Si granularity es DAILY, el startDate del período extendido del informe es el startDate de la cohorte más startOffset días.

Si granularity es WEEKLY, el startDate del período extendido del informe es el startDate de la cohorte más startOffset * 7 días.

Si granularity es MONTHLY, el startDate del período extendido del informe es el startDate de la cohorte más startOffset * 30 días.

integer

Obligatorio. endOffset especifica la fecha de finalización del período extendido del informe de un informe de cohorte. endOffset puede ser cualquier número entero positivo, pero suele establecerse entre 5 y 10, de modo que los informes contengan datos de la cohorte para los siguientes períodos de nivel de detalle.

Si granularity es DAILY, el endDate del período extendido del informe es el endDate de la cohorte más endOffset días.

Si granularity es WEEKLY, el endDate del período extendido del informe es el endDate de la cohorte más endOffset * 7 días.

Si granularity es MONTHLY, el endDate del período extendido del informe es el endDate de la cohorte más endOffset * 30 días.

{
  "accumulate": boolean
}

boolean

Si es verdadero, acumula el resultado desde el día del primer contacto hasta el día de finalización. No se admite en RunReportRequest.

{
  "creationQuotaTokensCharged": integer,
  "state": enum (State),
  "beginCreatingTime": string,
  "taskRowCount": integer,
  "errorMessage": string,
  "totalRowCount": integer
}

integer

Solo salida. Son los tokens de cuota totales que se cobraron durante la creación del informe. Debido a que este recuento de tokens se basa en la actividad del estado CREATING, el cargo de los tokens se corregirá una vez que una tarea de informe entre en el estado ACTIVE o FAILED.

enum (State)

Solo salida. El estado actual de esta tarea de informes.

string (Timestamp format)

Solo salida. El momento en que se llamó a reportTasks.create y el informe comenzó el estado CREATING.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

integer

Solo salida. Es la cantidad total de filas en el resultado del informe. Este campo se propagará cuando el estado esté activo. Puedes usar taskRowCount para la paginación dentro de los límites de su informe existente.

string

Solo salida. Se propaga un mensaje de error si una tarea de informe falla durante la creación.

integer

Solo salida. Es la cantidad total de filas en el almacenamiento de Google Analytics. Si quieres consultar filas de datos adicionales aparte del informe actual, el propietario puede iniciar una nueva tarea de informe en función del totalRowCount.

taskRowCount representa la cantidad de filas que pertenecen específicamente al informe actual, mientras que totalRowCount abarca el recuento total de filas en todos los datos recuperados del almacenamiento de Google Analytics.

Por ejemplo, supongamos que el taskRowCount del informe actual es 20, lo que muestra los datos de las primeras 20 filas. Al mismo tiempo, el totalRowCount es 30, lo que indica la presencia de datos para las 30 filas. Se puede usar la taskRowCount para paginar las 20 filas iniciales. Para expandir el informe e incluir datos de las 30 filas, se puede crear una nueva tarea de informe con totalRowCount para acceder al conjunto completo de datos de 30 filas.