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

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

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.

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

## bidding_data_exclusion.advertising_channel_types

Field descriptionThe 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.v25.enums.AdvertisingChannelTypeEnum.AdvertisingChannelType` FilterableTrue SelectableTrue SortableFalse RepeatedTrue Selectable with The following fields/resources can be selected with this field:
[bidding_data_exclusion](https://developers.google.com/google-ads/api/fields/v25/bidding_data_exclusion.md.txt)

## bidding_data_exclusion.campaigns

Field descriptionThe 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` FilterableTrue SelectableTrue SortableFalse RepeatedTrue Selectable with The following fields/resources can be selected with this field:
[bidding_data_exclusion](https://developers.google.com/google-ads/api/fields/v25/bidding_data_exclusion.md.txt)

## bidding_data_exclusion.data_exclusion_id

Field descriptionOutput only. The ID of the data exclusion.
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:
[bidding_data_exclusion](https://developers.google.com/google-ads/api/fields/v25/bidding_data_exclusion.md.txt)

## bidding_data_exclusion.description

Field descriptionThe description of the data exclusion. The description can be at
most 2048 characters.
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:
[bidding_data_exclusion](https://developers.google.com/google-ads/api/fields/v25/bidding_data_exclusion.md.txt)

## bidding_data_exclusion.devices

Field descriptionIf 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.v25.enums.DeviceEnum.Device` FilterableTrue SelectableTrue SortableFalse RepeatedTrue Selectable with The following fields/resources can be selected with this field:
[bidding_data_exclusion](https://developers.google.com/google-ads/api/fields/v25/bidding_data_exclusion.md.txt)

## bidding_data_exclusion.end_date_time

Field descriptionRequired. 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` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[bidding_data_exclusion](https://developers.google.com/google-ads/api/fields/v25/bidding_data_exclusion.md.txt)

## bidding_data_exclusion.name

Field descriptionThe name of the data exclusion. The name can be at most 255
characters.
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:
[bidding_data_exclusion](https://developers.google.com/google-ads/api/fields/v25/bidding_data_exclusion.md.txt)

## bidding_data_exclusion.resource_name

Field descriptionImmutable. 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` FilterableTrue SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[bidding_data_exclusion](https://developers.google.com/google-ads/api/fields/v25/bidding_data_exclusion.md.txt)

## bidding_data_exclusion.scope

Field descriptionThe scope of the data exclusion.
Category`ATTRIBUTE` Data Type `ENUM`
`CAMPAIGN``CHANNEL``CUSTOMER``UNKNOWN``UNSPECIFIED` Type URL`google.ads.googleads.v25.enums.SeasonalityEventScopeEnum.SeasonalityEventScope` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[bidding_data_exclusion](https://developers.google.com/google-ads/api/fields/v25/bidding_data_exclusion.md.txt)

## bidding_data_exclusion.start_date_time

Field descriptionRequired. 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` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[bidding_data_exclusion](https://developers.google.com/google-ads/api/fields/v25/bidding_data_exclusion.md.txt)

## bidding_data_exclusion.status

Field descriptionOutput only. The status of the data exclusion.
Category`ATTRIBUTE` Data Type `ENUM`
`ENABLED``REMOVED``UNKNOWN``UNSPECIFIED` Type URL`google.ads.googleads.v25.enums.SeasonalityEventStatusEnum.SeasonalityEventStatus` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[bidding_data_exclusion](https://developers.google.com/google-ads/api/fields/v25/bidding_data_exclusion.md.txt)