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.
bidding_data_exclusion
Stay organized with collections
Save and categorize content based on your preferences.
Help me build a query
Proto definition
Represents a bidding data exclusion. Bidding data exclusions can be set in
client accounts only, and cannot be used in manager accounts.
See "About data exclusions" at
https://support.google.com/google-ads/answer/10370710 .
Note: A customer account can have a maximum of 500 active bidding data
exclusions.
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.
bidding_data_exclusion.advertising_channel_types
Field description The data_exclusion will apply to all the campaigns under the listed
channels retroactively as well as going forward when the scope of this
exclusion is CHANNEL.
The supported advertising channel types are DISPLAY, SEARCH and SHOPPING.
Note: a data exclusion with both advertising_channel_types and
campaign_ids is not supported.
Category ATTRIBUTE
Data Type
ENUM
DEMAND_GEN
DISPLAY
HOTEL
LOCAL
LOCAL_SERVICES
MULTI_CHANNEL
PERFORMANCE_MAX
SEARCH
SHOPPING
SMART
TRAVEL
UNKNOWN
UNSPECIFIED
VIDEO
Type URL google.ads.googleads.v26.enums.AdvertisingChannelTypeEnum.AdvertisingChannelType
Filterable True
Selectable True
Sortable False
Repeated True
Selectable with
The following fields/resources can be selected with this field:
bidding_data_exclusion.campaigns
Field description The data exclusion will apply to the campaigns listed when the scope of
this exclusion is CAMPAIGN. The maximum number of campaigns per event is
2000.
Note: a data exclusion with both advertising_channel_types and
campaign_ids is not supported.
Category ATTRIBUTE
Data Type RESOURCE_NAME
Type URL N/A
Filterable True
Selectable True
Sortable False
Repeated True
Selectable with
The following fields/resources can be selected with this field:
bidding_data_exclusion.data_exclusion_id
Field description Output only. The ID of the data exclusion.
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:
bidding_data_exclusion.description
Field description The description of the data exclusion. The description can be at
most 2048 characters.
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:
bidding_data_exclusion.devices
Field description If not specified, all devices will be included in this exclusion.
Otherwise, only the specified targeted devices will be included in this
exclusion.
Category ATTRIBUTE
Data Type
ENUM
CONNECTED_TV
DESKTOP
MOBILE
OTHER
TABLET
UNKNOWN
UNSPECIFIED
Type URL google.ads.googleads.v26.enums.DeviceEnum.Device
Filterable True
Selectable True
Sortable False
Repeated True
Selectable with
The following fields/resources can be selected with this field:
bidding_data_exclusion.end_date_time
Field description Required. The exclusive end time of the data exclusion in yyyy-MM-dd
HH:mm:ss format.
The length of [start_date_time, end_date_time) interval must be
within (0, 14 days].
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:
bidding_data_exclusion.name
Field description The name of the data exclusion. The name can be at most 255
characters.
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:
bidding_data_exclusion.resource_name
Field description Immutable. The resource name of the data exclusion.
Data exclusion resource names have the form:
customers/{customer_id}/biddingDataExclusions/{data_exclusion_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:
bidding_data_exclusion.start_date_time
Field description Required. The inclusive start time of the data exclusion in yyyy-MM-dd
HH:mm:ss format.
A data exclusion is backward looking and should be used for events that
start in the past and end either in the past or future.
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:
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."],[],[]]