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 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.
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
Capabilities Selectable: True Filterable: True Sortable: False Repeated: True
Selectable with
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
Capabilities Selectable: True Filterable: True Sortable: False Repeated: True
Selectable with
bidding_data_exclusion.data_exclusion_id
Field description Output only. The ID of the data exclusion.
Category ATTRIBUTE
Data Type INT64
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with
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
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with
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
Capabilities Selectable: True Filterable: True Sortable: False Repeated: True
Selectable with
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
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with
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
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with
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
Capabilities Selectable: True Filterable: True Sortable: False Repeated: False
Selectable with
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
Capabilities Selectable: True Filterable: True Sortable: True Repeated: False
Selectable with
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."],[],[]]