- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- RunPivotReportRequest
- Pruébala
Muestra varios informes dinámicos en un lote. Todos los informes deben ser para la misma propiedad GA4.
Solicitud HTTP
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:batchRunPivotReports
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
property |
Es un identificador de propiedad GA4 de Google Analytics cuyos eventos se rastrean. Se especifica en la ruta de URL y no en el cuerpo. Para obtener más información, consulta dónde encontrar tu ID de propiedad. Esta propiedad se debe especificar para el lote. Es posible que la propiedad dentro de RunPivotReportRequest no esté especificada o sea coherente con esta propiedad. Ejemplo: properties/1234 |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{
"requests": [
{
object ( |
Campos | |
---|---|
requests[] |
Solicitudes individuales. Cada solicitud tiene una respuesta independiente para el informe dinámico. Cada solicitud por lotes admite hasta 5 solicitudes. |
Cuerpo de la respuesta
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Es la respuesta por lotes que contiene varios informes de tabla dinámica.
Representación JSON |
---|
{
"pivotReports": [
{
object ( |
Campos | |
---|---|
pivotReports[] |
Respuestas individuales. Cada respuesta tiene una solicitud de informe de pivote independiente. |
kind |
Identifica el tipo de recurso que es este mensaje. Este |
Permisos de autorización
Se necesita uno de los siguientes alcances de OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
RunPivotReportRequest
Es la solicitud para generar un informe de tabla dinámica.
Representación JSON |
---|
{ "property": string, "dimensions": [ { object ( |
Campos | |
---|---|
property |
Es un identificador de propiedad GA4 de Google Analytics cuyos eventos se rastrean. Se especifica en la ruta de URL y no en el cuerpo. Para obtener más información, consulta dónde encontrar tu ID de propiedad. Dentro de una solicitud por lotes, esta propiedad no debe especificarse o ser coherente con la propiedad a nivel del lote. Ejemplo: properties/1234 |
dimensions[] |
Las dimensiones solicitadas. Todas las dimensiones definidas deben ser utilizadas por una de las siguientes opciones: dimensionExpression, dimensionFilter, pivots y targetSdkVersions. |
metrics[] |
Se deben especificar las métricas solicitadas. Para usar todas las métricas definidas, use uno de los siguientes parámetros: metric_expression, metricFilter, targetSdkVersions. |
dateRanges[] |
Es el período que se utiliza para recuperar los datos del evento del informe. Si se especifican varios períodos, los datos de eventos de cada uno se usan en el informe. Se puede incluir una dimensión especial con el nombre de campo "dateRange" en los nombres de campo de Pivot; si se incluye, el informe compara entre períodos. En una solicitud de cohorte, este |
pivots[] |
Describe el formato visual de las dimensiones del informe en columnas o filas. La unión de los fieldNames (nombres de dimensiones) en todos los pivotes debe ser un subconjunto de nombres de dimensiones definidos en Dimensiones. No hay dos elementos dinámicos que puedan compartir una dimensión. Una dimensión solo es visible si aparece en una tabla dinámica. |
dimensionFilter |
La cláusula de filtro de las dimensiones. Es necesario solicitar el uso de las dimensiones de este filtro. No se pueden usar las métricas en este filtro. |
metricFilter |
La cláusula de filtro de las métricas. Se aplica en la fase de agregación posterior, similar a la cláusula de SQL. Se deben solicitar métricas para que se las use en este filtro. No se pueden usar las dimensiones en este filtro. |
currencyCode |
Un código de moneda en formato ISO 4217, como "AED", "USD" o "JPY". Si el campo está vacío, el informe usa la moneda predeterminada de la propiedad. |
cohortSpec |
Grupo de cohorte asociado con esta solicitud Si hay un grupo de cohorte en la solicitud, la dimensión "cohorte" debe estar presente. |
keepEmptyRows |
Si es falso o no se especifica, no se mostrará cada fila con todas las métricas iguales a 0. Si es verdadero, se mostrarán estas filas si un filtro no las quita por separado. Independientemente de esta configuración de Por ejemplo, si una propiedad nunca registra un evento |
returnPropertyQuota |
Alterna si se muestra el estado actual de la cuota de esta propiedad de Analytics. La cuota se muestra en PropertyQuota. |