Google Analytics · JSON Structure

Data Api Audience Export Structure

An audience export is a list of users in an audience at the time of the list's creation. One audience may have multiple audience exports created for different days.

Type: object Properties: 10
AnalyticsDataGoogleMetricsReportingWeb AnalyticsMachine LearningAttribution

AudienceExport is a JSON Structure definition published by Google Analytics, describing 10 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

audience audienceDisplayName beginCreatingTime creationQuotaTokensCharged dimensions errorMessage name percentageCompleted rowCount state

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/google-analytics/refs/heads/main/json-structure/data-api-audience-export-structure.json",
  "name": "AudienceExport",
  "description": "An audience export is a list of users in an audience at the time of the list's creation. One audience may have multiple audience exports created for different days.",
  "type": "object",
  "properties": {
    "audience": {
      "description": "Required. The audience resource name. This resource name identifies the audience being listed and is shared between the Analytics Data & Admin APIs. Format: `properties/{property}/audiences/{audience}`",
      "type": "string",
      "example": "example_value"
    },
    "audienceDisplayName": {
      "description": "Output only. The descriptive display name for this audience. For example, \"Purchasers\".",
      "readOnly": true,
      "type": "string",
      "example": "Example Name"
    },
    "beginCreatingTime": {
      "description": "Output only. The time when CreateAudienceExport was called and the AudienceExport began the `CREATING` state.",
      "readOnly": true,
      "type": "datetime",
      "example": "2026-04-17T12:00:00Z"
    },
    "creationQuotaTokensCharged": {
      "description": "Output only. The total quota tokens charged during creation of the AudienceExport. Because this token count is based on activity from the `CREATING` state, this tokens charged will be fixed once an AudienceExport enters the `ACTIVE` or `FAILED` states.",
      "readOnly": true,
      "type": "int32",
      "example": 42
    },
    "dimensions": {
      "description": "Required. The dimensions requested and displayed in the query response.",
      "items": {
        "description": "An audience dimension is a user attribute. Specific user attributed are requested and then later returned in the `QueryAudienceExportResponse`.",
        "properties": {
          "dimensionName": {
            "description": "Optional. The API name of the dimension. See the [API Dimensions](https://developers.google.com/analytics/devguides/reporting/data/v1/audience-list-api-schema#dimensions) for the list of dimension names.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "errorMessage": {
      "description": "Output only. Error message is populated when an audience export fails during creation. A common reason for such a failure is quota exhaustion.",
      "readOnly": true,
      "type": "string",
      "example": "example_value"
    },
    "name": {
      "description": "Output only. Identifier. The audience export resource name assigned during creation. This resource name identifies this `AudienceExport`. Format: `properties/{property}/audienceExports/{audience_export}`",
      "readOnly": true,
      "type": "string",
      "example": "Example Name"
    },
    "percentageCompleted": {
      "description": "Output only. The percentage completed for this audience export ranging between 0 to 100.",
      "readOnly": true,
      "type": "double",
      "example": 75.5
    },
    "rowCount": {
      "description": "Output only. The total number of rows in the AudienceExport result.",
      "readOnly": true,
      "type": "int32",
      "example": 10
    },
    "state": {
      "description": "Output only. The current state for this AudienceExport.",
      "enum": [
        "STATE_UNSPECIFIED",
        "CREATING",
        "ACTIVE",
        "FAILED"
      ],
      "readOnly": true,
      "type": "string",
      "example": "STATE_UNSPECIFIED"
    }
  }
}