Skip to content

Up to five reports on one property in one request.

Returns multiple reports in a batch. All reports must be for the same Google Analytics property.

Job analytics.reports.batch

Your AI asks

checks the price first
telipot run google-analytics.reports.batch \
  --input-json '{"propertyId":"123456789","requests":[{"dateRanges":[{"startDate":"2026-09-01","endDate":"2026-09-30"}],"dimensions":[{"name":"country"}],"metrics":[{"name":"activeUsers"}]}]}' \
  --quote

Price

Free
Priced· before it runs

google-analytics.reports.batch

FreeCompany account

Whose account it uses

1The person asking
skipped
2Your company’s Google Analytics 4 account
Selected identity for this example
3Our account
not used

What it sends

{
  "propertyId": "123456789",
  "requests": [{"dateRanges":[{"startDate":"2026-09-01","endDate":"2026-09-30"}],"dimensions":[{"name":"country"}],"metrics":[{"name":"activeUsers"}]}]
}

Your Google Analytics 4 login is added for you. Your AI never sees it.

What it costs

Free

no charge from the provider

Preview the price first. --quote runs nothing.

For developers · run it

Shell · runs the task on the named account

telipot run google-analytics.reports.batch \
  --input-json '{"propertyId":"123456789","requests":[{"dateRanges":[{"startDate":"2026-09-01","endDate":"2026-09-30"}],"dimensions":[{"name":"country"}],"metrics":[{"name":"activeUsers"}]}]}'

propertyId

string · required · path

The numeric id of a GA4 property, as google-analytics.accounts.summaries returns it after properties/

requests

array · required · at most 5 · body

Up to 5 report requests, each the body of google-analytics.reports.run; the property is the one in the path

reports

object[]

One report per request, in order, each shaped as the answer of google-analytics.reports.run

kind

string

Full output schema · JSONNested fields and constraints

Output JSON Schema

{
  "type": "object",
  "properties": {
    "reports": {
      "type": "array",
      "description": "One report per request, in order, each shaped as the answer of google-analytics.reports.run",
      "items": {
        "type": "object",
        "properties": {
          "dimensionHeaders": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                }
              }
            }
          },
          "metricHeaders": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "type": {
                  "type": "string"
                }
              }
            }
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "dimensionValues": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "value": {
                        "type": "string"
                      }
                    }
                  }
                },
                "metricValues": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "value": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          },
          "rowCount": {
            "type": "integer"
          },
          "metadata": {
            "type": "object"
          },
          "kind": {
            "type": "string"
          }
        }
      }
    },
    "kind": {
      "type": "string"
    }
  }
}

A real answer

examples/google-analytics.reports.batch.json

{
  "reports": [
    {
      "dimensionHeaders": [
        {
          "name": "country"
        }
      ],
      "metricHeaders": [
        {
          "name": "activeUsers",
          "type": "TYPE_INTEGER"
        }
      ],
      "rows": [
        {
          "dimensionValues": [
            {
              "value": "United States"
            }
          ],
          "metricValues": [
            {
              "value": "1842"
            }
          ]
        },
        {
          "dimensionValues": [
            {
              "value": "Germany"
            }
          ],
          "metricValues": [
            {
              "value": "311"
            }
          ]
        }
      ],
      "rowCount": 37,
      "metadata": {
        "currencyCode": "USD",
        "timeZone": "America/Los_Angeles"
      },
      "kind": "analyticsData#runReport"
    }
  ],
  "kind": "analyticsData#batchRunReports"
}