> [!CAUTION]
> **Caution:** This documentation is for Google Ads API **v23** . The latest active version is [**v26**](https://developers.google.com/google-ads/api/fields/latest/audience).

[Help me build a query](https://developers.google.com/google-ads/api/fields/v23/audience_query_builder.md.txt) [Proto definition ![on GitHub](https://developers.google.com/site-assets/logo-github.svg)](https://github.com/googleapis/googleapis/blob/master/google/ads/googleads/v23/resources/audience.proto)

Audience is an effective targeting option that lets you
intersect different segment attributes, such as detailed demographics and
affinities, to create audiences that represent sections of your target
segments.

| Attributed resources |
|---|
| [asset_group](https://developers.google.com/google-ads/api/fields/v23/asset_group.md.txt) |
| [customer](https://developers.google.com/google-ads/api/fields/v23/customer.md.txt) |

Fields from the preceding resources can be selected along with this
resource in your `SELECT` and `WHERE` clauses. These fields do **not** segment
metrics in your `SELECT` clause.

## audience.asset_group

Field descriptionImmutable. The asset group that this audience is scoped under. Must be set
if and only if scope is ASSET_GROUP. Immutable after creation. If an
audience with ASSET_GROUP scope is upgraded to CUSTOMER scope, this field
will automatically be cleared.
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` CapabilitiesSelectable: True  
Filterable: True  
Sortable: False  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

**Resources:** [audience](https://developers.google.com/google-ads/api/fields/v23/audience.md.txt)

## audience.description

Field descriptionDescription of this audience.
Category`ATTRIBUTE` Data Type`STRING` CapabilitiesSelectable: True  
Filterable: True  
Sortable: True  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

**Resources:** [audience](https://developers.google.com/google-ads/api/fields/v23/audience.md.txt)

## audience.dimensions

Field descriptionPositive dimensions specifying the audience composition.
Category`ATTRIBUTE` Data Type`MESSAGE` Type URL`google.ads.googleads.v23.common.AudienceDimension` CapabilitiesSelectable: True  
Filterable: False  
Sortable: False  
Repeated: True Selectable withThe following fields and resources can be selected with this field:

**Resources:** [audience](https://developers.google.com/google-ads/api/fields/v23/audience.md.txt)

## audience.dimensions.audience_segments.segments.custom_audience.custom_audience

Field descriptionThe custom audience resource.
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` CapabilitiesSelectable: False  
Filterable: True  
Sortable: False  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

**Resources:** [audience](https://developers.google.com/google-ads/api/fields/v23/audience.md.txt)

## audience.dimensions.audience_segments.segments.detailed_demographic.detailed_demographic

Field descriptionThe detailed demographic resource.
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` CapabilitiesSelectable: False  
Filterable: True  
Sortable: False  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

**Resources:** [audience](https://developers.google.com/google-ads/api/fields/v23/audience.md.txt)

## audience.dimensions.audience_segments.segments.life_event.life_event

Field descriptionThe life event resource.
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` CapabilitiesSelectable: False  
Filterable: True  
Sortable: False  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

**Resources:** [audience](https://developers.google.com/google-ads/api/fields/v23/audience.md.txt)

## audience.dimensions.audience_segments.segments.user_interest.user_interest_category

Field descriptionThe user interest resource.
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` CapabilitiesSelectable: False  
Filterable: True  
Sortable: False  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

**Resources:** [audience](https://developers.google.com/google-ads/api/fields/v23/audience.md.txt)

## audience.dimensions.audience_segments.segments.user_list.user_list

Field descriptionThe user list resource.
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` CapabilitiesSelectable: False  
Filterable: True  
Sortable: False  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

**Resources:** [audience](https://developers.google.com/google-ads/api/fields/v23/audience.md.txt)

## audience.exclusion_dimension

Field descriptionNegative dimension specifying the audience composition.
Category`ATTRIBUTE` Data Type`MESSAGE` Type URL`google.ads.googleads.v23.common.AudienceExclusionDimension` CapabilitiesSelectable: True  
Filterable: False  
Sortable: False  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

**Resources:** [audience](https://developers.google.com/google-ads/api/fields/v23/audience.md.txt)

## audience.exclusion_dimension.exclusions.user_list.user_list

Field descriptionThe user list resource.
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` CapabilitiesSelectable: False  
Filterable: True  
Sortable: False  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

**Resources:** [audience](https://developers.google.com/google-ads/api/fields/v23/audience.md.txt)

## audience.id

Field descriptionOutput only. ID of the audience.
Category`ATTRIBUTE` Data Type`INT64` CapabilitiesSelectable: True  
Filterable: True  
Sortable: True  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

**Resources:** [audience](https://developers.google.com/google-ads/api/fields/v23/audience.md.txt)

## audience.name

Field descriptionName of the audience. It should be unique across all audiences within the
account. It must have a minimum length of 1 and maximum length of 255.
Required when scope is not set or is set to CUSTOMER. Cannot be set or
updated when scope is ASSET_GROUP.
Category`ATTRIBUTE` Data Type`STRING` CapabilitiesSelectable: True  
Filterable: True  
Sortable: True  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

Same as [audience.id](https://developers.google.com/google-ads/api/fields/v23/audience.md.txt#audience.id).

## audience.resource_name

Field descriptionImmutable. The resource name of the audience.
Audience names have the form:

`customers/{customer_id}/audiences/{audience_id}`
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` CapabilitiesSelectable: True  
Filterable: True  
Sortable: False  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

Same as [audience.id](https://developers.google.com/google-ads/api/fields/v23/audience.md.txt#audience.id).

## audience.scope

Field descriptionDefines the scope this audience can be used in. By default, the scope is
CUSTOMER. Audiences can be created with a scope of ASSET_GROUP for
exclusive use by a single asset_group. Scope may change from ASSET_GROUP to
CUSTOMER but not from CUSTOMER to ASSET_GROUP.
Category`ATTRIBUTE` Data Type`ENUM`
`ASSET_GROUP``CUSTOMER``UNKNOWN``UNSPECIFIED` Type URL`google.ads.googleads.v23.enums.AudienceScopeEnum.AudienceScope` CapabilitiesSelectable: True  
Filterable: True  
Sortable: True  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

Same as [audience.id](https://developers.google.com/google-ads/api/fields/v23/audience.md.txt#audience.id).

## audience.status

Field descriptionOutput only. Status of this audience. Indicates whether the audience
is enabled or removed.
Category`ATTRIBUTE` Data Type`ENUM`
`ENABLED``REMOVED``UNKNOWN``UNSPECIFIED` Type URL`google.ads.googleads.v23.enums.AudienceStatusEnum.AudienceStatus` CapabilitiesSelectable: True  
Filterable: True  
Sortable: True  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

Same as [audience.id](https://developers.google.com/google-ads/api/fields/v23/audience.md.txt#audience.id).