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