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

[<button style="margin-top:15px">Help me build a query</button>](https://developers.google.com/google-ads/api/fields/v25/audience_query_builder.md.txt) [<button style="margin-top:15px">Proto definition ![GitHub](https://developers.google.com/site-assets/logo-github.svg)</button>](https://github.com/googleapis/googleapis/blob/master/google/ads/googleads/v25/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/v25/asset_group.md.txt) |
| [customer](https://developers.google.com/google-ads/api/fields/v25/customer.md.txt) |

Fields from the above resources may be selected along with this
resource in your SELECT and WHERE clauses. These fields **will 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` Type URL`N/A` FilterableTrue SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[audience](https://developers.google.com/google-ads/api/fields/v25/audience.md.txt)

## audience.description

Field descriptionDescription of this audience.
Category`ATTRIBUTE` Data Type`STRING` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[audience](https://developers.google.com/google-ads/api/fields/v25/audience.md.txt)

## audience.dimensions

Field descriptionPositive dimensions specifying the audience composition.
Category`ATTRIBUTE` Data Type`MESSAGE` Type URL`google.ads.googleads.v25.common.AudienceDimension` FilterableFalse SelectableTrue SortableFalse RepeatedTrue Selectable with The following fields/resources can be selected with this field:
[audience](https://developers.google.com/google-ads/api/fields/v25/audience.md.txt)

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

Field descriptionThe custom audience resource.
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` Type URL`N/A` FilterableTrue SelectableFalse SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[audience](https://developers.google.com/google-ads/api/fields/v25/audience.md.txt)

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

Field descriptionThe detailed demographic resource.
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` Type URL`N/A` FilterableTrue SelectableFalse SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[audience](https://developers.google.com/google-ads/api/fields/v25/audience.md.txt)

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

Field descriptionThe life event resource.
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` Type URL`N/A` FilterableTrue SelectableFalse SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[audience](https://developers.google.com/google-ads/api/fields/v25/audience.md.txt)

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

Field descriptionThe user interest resource.
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` Type URL`N/A` FilterableTrue SelectableFalse SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[audience](https://developers.google.com/google-ads/api/fields/v25/audience.md.txt)

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

Field descriptionThe user list resource.
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` Type URL`N/A` FilterableTrue SelectableFalse SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[audience](https://developers.google.com/google-ads/api/fields/v25/audience.md.txt)

## audience.exclusion_dimension

Field descriptionNegative dimension specifying the audience composition.
Category`ATTRIBUTE` Data Type`MESSAGE` Type URL`google.ads.googleads.v25.common.AudienceExclusionDimension` FilterableFalse SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[audience](https://developers.google.com/google-ads/api/fields/v25/audience.md.txt)

## audience.exclusion_dimension.exclusions.user_list.user_list

Field descriptionThe user list resource.
Category`ATTRIBUTE` Data Type`RESOURCE_NAME` Type URL`N/A` FilterableTrue SelectableFalse SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[audience](https://developers.google.com/google-ads/api/fields/v25/audience.md.txt)

## audience.id

Field descriptionOutput only. ID of the audience.
Category`ATTRIBUTE` Data Type`INT64` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[audience](https://developers.google.com/google-ads/api/fields/v25/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` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[audience](https://developers.google.com/google-ads/api/fields/v25/audience.md.txt)

## 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` Type URL`N/A` FilterableTrue SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[audience](https://developers.google.com/google-ads/api/fields/v25/audience.md.txt)

## 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.v25.enums.AudienceScopeEnum.AudienceScope` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[audience](https://developers.google.com/google-ads/api/fields/v25/audience.md.txt)

## 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.v25.enums.AudienceStatusEnum.AudienceStatus` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[audience](https://developers.google.com/google-ads/api/fields/v25/audience.md.txt)