Join us live on
Discord on the Google Advertising and Measurement Community server and on
YouTube on October 15th at 10:00 AM EST! We will discuss the new features added in v26 of the Google Ads API.
custom_interest
Stay organized with collections
Save and categorize content based on your preferences.
Help me build a query
Proto definition
A custom interest. This is a list of users by interest.
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_interest.description
Field description Description of this custom interest audience.
Category ATTRIBUTE
Data Type STRING
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False
Selectable with
The following fields/resources can be selected with this field:
custom_interest.id
Field description Output only. Id of the custom interest.
Category ATTRIBUTE
Data Type INT64
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False
Selectable with
The following fields/resources can be selected with this field:
custom_interest.members
Field description List of custom interest members that this custom interest is composed of.
Members can be added during CustomInterest 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.CustomInterestMember
Filterable False
Selectable True
Sortable False
Repeated True
Selectable with
The following fields/resources can be selected with this field:
custom_interest.name
Field description Name of the custom interest. It should be unique across the same custom
affinity audience.
This field is required for create operations.
Category ATTRIBUTE
Data Type STRING
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False
Selectable with
The following fields/resources can be selected with this field:
custom_interest.resource_name
Field description Immutable. The resource name of the custom interest.
Custom interest resource names have the form:
customers/{customer_id}/customInterests/{custom_interest_id}
Category ATTRIBUTE
Data Type RESOURCE_NAME
Type URL N/A
Filterable True
Selectable True
Sortable False
Repeated False
Selectable with
The following fields/resources can be selected with this field:
custom_interest.status
Field description Status of this custom interest. Indicates whether the custom interest is
enabled or removed.
Category ATTRIBUTE
Data Type
ENUM
ENABLED
REMOVED
UNKNOWN
UNSPECIFIED
Type URL google.ads.googleads.v26.enums.CustomInterestStatusEnum.CustomInterestStatus
Filterable True
Selectable True
Sortable True
Repeated False
Selectable with
The following fields/resources can be selected with this field:
custom_interest.type
Field description Type of the custom interest, CUSTOM_AFFINITY or CUSTOM_INTENT.
By default the type is set to CUSTOM_AFFINITY.
Category ATTRIBUTE
Data Type
ENUM
CUSTOM_AFFINITY
CUSTOM_INTENT
UNKNOWN
UNSPECIFIED
Type URL google.ads.googleads.v26.enums.CustomInterestTypeEnum.CustomInterestType
Filterable True
Selectable True
Sortable True
Repeated False
Selectable with
The following fields/resources can be selected with this field:
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-10-14 UTC.
[null,null,["Last updated 2026-10-14 UTC."],[],[]]