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

[<button style="margin-top:15px">Help me build a query</button>](https://developers.google.com/google-ads/api/fields/v24/custom_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/v24/resources/custom_audience.proto)

A custom audience. This is a list of users by interest.
The unique key of a custom audience consists of the following fields: name.
Violating the unique key constraint produces error:
CustomAudienceError.NAME_ALREADY_USED

| Attributed resources |
|---|
| [customer](https://developers.google.com/google-ads/api/fields/v24/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.

## custom_audience.description

Field descriptionDescription of this custom 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:
[custom_audience](https://developers.google.com/google-ads/api/fields/v24/custom_audience.md.txt)

## custom_audience.id

Field descriptionOutput only. ID of the custom 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:
[custom_audience](https://developers.google.com/google-ads/api/fields/v24/custom_audience.md.txt)

## custom_audience.members

Field descriptionList of custom audience members that this custom audience is composed of.
Members can be added during CustomAudience creation. If members are
presented in UPDATE operation, existing members will be overridden.
Category`ATTRIBUTE` Data Type`MESSAGE` Type URL`google.ads.googleads.v24.resources.CustomAudienceMember` FilterableFalse SelectableTrue SortableFalse RepeatedTrue Selectable with The following fields/resources can be selected with this field:
[custom_audience](https://developers.google.com/google-ads/api/fields/v24/custom_audience.md.txt)

## custom_audience.name

Field descriptionName of the custom audience. It should be unique for all custom audiences
created by a customer.
This field is required for creating operations.
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:
[custom_audience](https://developers.google.com/google-ads/api/fields/v24/custom_audience.md.txt)

## custom_audience.resource_name

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

`customers/{customer_id}/customAudiences/{custom_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:
[custom_audience](https://developers.google.com/google-ads/api/fields/v24/custom_audience.md.txt)

## custom_audience.status

Field descriptionOutput only. Status of this custom audience. Indicates whether the custom
audience is enabled or removed.
Category`ATTRIBUTE` Data Type `ENUM`
`ENABLED``REMOVED``UNKNOWN``UNSPECIFIED` Type URL`google.ads.googleads.v24.enums.CustomAudienceStatusEnum.CustomAudienceStatus` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[custom_audience](https://developers.google.com/google-ads/api/fields/v24/custom_audience.md.txt)

## custom_audience.type

Field descriptionType of the custom audience.
("INTEREST" OR "PURCHASE_INTENT" is not allowed for newly created custom
audience but kept for existing audiences)
Category`ATTRIBUTE` Data Type `ENUM`
`AUTO``INTEREST``PURCHASE_INTENT``SEARCH``UNKNOWN``UNSPECIFIED` Type URL`google.ads.googleads.v24.enums.CustomAudienceTypeEnum.CustomAudienceType` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[custom_audience](https://developers.google.com/google-ads/api/fields/v24/custom_audience.md.txt)