custom_audience
Stay organized with collections
Save and categorize content based on your preferences.
Help me build a query
Proto definition
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
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.
custom_audience.description
Field description Description of this custom audience.
Category ATTRIBUTE
Data Type STRING
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: custom_audience
custom_audience.id
Field description Output only. ID of the custom audience.
Category ATTRIBUTE
Data Type INT64
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Resources: custom_audience
custom_audience.members
Field description List 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.v26.resources.CustomAudienceMember
Capabilities Selectable: True Filterable: False Sortable: False Repeated: True
Selectable with The following fields and resources can be selected with this field:
Same as custom_audience.id .
custom_audience.name
Field description Name 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
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Same as custom_audience.id .
custom_audience.resource_name
Field description Immutable. 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
Capabilities Selectable: True Filterable: True Sortable: False Repeated: False
Selectable with The following fields and resources can be selected with this field:
Same as custom_audience.id .
custom_audience.status
Field description Output 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.v26.enums.CustomAudienceStatusEnum.CustomAudienceStatus
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Same as custom_audience.id .
custom_audience.type
Field description Type 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.v26.enums.CustomAudienceTypeEnum.CustomAudienceType
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with The following fields and resources can be selected with this field:
Same as custom_audience.id .
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-11-17 UTC.
[null,null,["Last updated 2026-11-17 UTC."],[],[]]