bidding_data_exclusion

Help me build a query Proto definition on GitHub

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

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.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v26.enums.AdvertisingChannelTypeEnum.AdvertisingChannelType
CapabilitiesSelectable: 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.

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
CapabilitiesSelectable: 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.

CategoryATTRIBUTE
Data TypeINT64
CapabilitiesSelectable: 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.

CategoryATTRIBUTE
Data TypeSTRING
CapabilitiesSelectable: 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.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v26.enums.DeviceEnum.Device
CapabilitiesSelectable: 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].

CategoryATTRIBUTE
Data TypeSTRING
CapabilitiesSelectable: 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.

CategoryATTRIBUTE
Data TypeSTRING
CapabilitiesSelectable: 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}

CategoryATTRIBUTE
Data TypeRESOURCE_NAME
CapabilitiesSelectable: True
Filterable: True
Sortable: False
Repeated: False
Selectable with

bidding_data_exclusion.scope

Field description

The scope of the data exclusion.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v26.enums.SeasonalityEventScopeEnum.SeasonalityEventScope
CapabilitiesSelectable: True
Filterable: True
Sortable: True
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.

CategoryATTRIBUTE
Data TypeSTRING
CapabilitiesSelectable: True
Filterable: True
Sortable: True
Repeated: False
Selectable with

bidding_data_exclusion.status

Field description

Output only. The status of the data exclusion.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v26.enums.SeasonalityEventStatusEnum.SeasonalityEventStatus
CapabilitiesSelectable: True
Filterable: True
Sortable: True
Repeated: False
Selectable with