Analytics Data Service

The Analytics Data service allows you to use the Google Analytics Data API v1 in Apps Script. This API gives Google Analytics users programmatic access to Google Analytics 4 (GA4) report data.


For detailed information on this service, see the Google Analytics Data API v1 reference documentation.

Like all advanced services in Apps Script, the AnalyticsData service uses the same objects, methods, and parameters as the public API. For more information, see How method signatures are determined.

To report issues and find other support, see the Google Analytics Data API v1 support page.

Sample code

Run a report

The sample runs a report to retrieve the active users count by city and stores the results in a new spreadsheet.

 * Runs a report of a Google Analytics 4 property ID. Creates a sheet with the
 * report.
function runReport() {
   * TODO(developer): Uncomment this variable and replace with your
   *   Google Analytics 4 property ID before running the sample.
  const propertyId = 'YOUR-GA4-PROPERTY-ID';

  try {
    const metric = AnalyticsData.newMetric(); = 'activeUsers';

    const dimension = AnalyticsData.newDimension(); = 'city';

    const dateRange = AnalyticsData.newDateRange();
    dateRange.startDate = '2020-03-31';
    dateRange.endDate = 'today';

    const request = AnalyticsData.newRunReportRequest();
    request.dimensions = [dimension];
    request.metrics = [metric];
    request.dateRanges = dateRange;

    const report = AnalyticsData.Properties.runReport(request,
        'properties/' + propertyId);
    if (!report.rows) {
      console.log('No rows returned.');

    const spreadsheet = SpreadsheetApp.create('Google Analytics Report');
    const sheet = spreadsheet.getActiveSheet();

    // Append the headers.
    const dimensionHeaders =
        (dimensionHeader) => {
    const metricHeaders =
        (metricHeader) => {
    const headers = [...dimensionHeaders, ...metricHeaders];


    // Append the results.
    const rows = => {
      const dimensionValues =
          (dimensionValue) => {
            return dimensionValue.value;
      const metricValues =
          (metricValues) => {
            return metricValues.value;
      return [...dimensionValues, ...metricValues];

    sheet.getRange(2, 1, report.rows.length, headers.length)

    console.log('Report spreadsheet created: %s',
  } catch (e) {
    // TODO (Developer) - Handle exception
    console.log('Failed with error: %s', e.error);