# REST Resource: bidders.filterSets

- [Resource: FilterSet](https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.filterSets#FilterSet)
  - [JSON representation](https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.filterSets#FilterSet.SCHEMA_REPRESENTATION)
- [Methods](https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.filterSets#METHODS_SUMMARY)

## Resource: FilterSet

A set of filters that is applied to a request for data. Within a filter set, an AND operation is performed across the filters represented by each field. An OR operation is performed across the filters represented by the multiple values of a repeated field, for example, "format=VIDEO AND dealId=12 AND (seller_network_id=34 OR seller_network_id=56)".

| JSON representation ||
|---|---|
| ``` { "name": string, "timeSeriesGranularity": enum (`https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet.TimeSeriesGranularity`), "creativeId": string, "dealId": string, "formats": [ enum (`https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet.Format`) ], "format": enum (`https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet.Format`), "environment": enum (`https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet.Environment`), "platforms": [ enum (`https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet.Platform`) ], "sellerNetworkIds": [ integer ], "publisherIdentifiers": [ string ], "breakdownDimensions": [ enum (`https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet.BreakdownDimension`) ], // Union field `time_range` can be only one of the following: "relativeDateRange": { object (`https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet.RelativeDateRange`) }, "absoluteDateRange": { object (`https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet.AbsoluteDateRange`) }, "realtimeTimeRange": { object (`https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet.RealtimeTimeRange`) } // End of list of possible types for union field `time_range`. } ``` |

| Fields ||
|---|---|---|
| `name` | `string` A user-defined name of the filter set. Filter set names must be unique globally and match one of the patterns: - `bidders/*/filterSets/*` (for accessing bidder-level troubleshooting data) - `bidders/*/accounts/*/filterSets/*` (for accessing account-level troubleshooting data) This field is required in create operations. |
| `timeSeriesGranularity` | ``enum (`https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet.TimeSeriesGranularity`)`` The granularity of time intervals if a time series breakdown is preferred; optional. |
| `creativeId` | `string` The ID of the creative on which to filter; optional. This field may be set only for a filter set that accesses account-level troubleshooting data, for example, one whose name matches the `bidders/*/accounts/*/filterSets/*` pattern. |
| `dealId` | `string (https://developers.google.com/discovery/v1/type-format format)` The ID of the deal on which to filter; optional. This field may be set only for a filter set that accesses account-level troubleshooting data, for example, one whose name matches the `bidders/*/accounts/*/filterSets/*` pattern. |
| `formats[] (deprecated)` | ``enum (`https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet.Format`)`` > [!WARNING] > use `https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet.FIELDS.format` instead. Creative formats bidded on or allowed to bid on, can be empty. Although this field is a list, it can only be populated with a single item. A HTTP 400 bad request error will be returned in the response if you specify multiple items. |
| `format` | ``enum (`https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet.Format`)`` Creative format bidded on or allowed to bid on, can be empty. |
| `environment` | ``enum (`https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet.Environment`)`` The environment on which to filter; optional. |
| `platforms[]` | ``enum (`https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet.Platform`)`` The list of platforms on which to filter; may be empty. The filters represented by multiple platforms are ORed together (for example, if non-empty, results must match any one of the platforms). |
| `sellerNetworkIds[]` | `integer` For Authorized Buyers only. The list of IDs of the seller (publisher) networks on which to filter; may be empty. The filters represented by multiple seller network IDs are ORed together (for example, if non-empty, results must match any one of the publisher networks). See [seller-network-ids](https://developers.google.com/authorized-buyers/rtb/downloads/seller-network-ids) file for the set of existing seller network IDs. |
| `publisherIdentifiers[]` | `string` For Open Bidding partners only. The list of publisher identifiers on which to filter; may be empty. The filters represented by multiple publisher identifiers are ORed together. |
| `breakdownDimensions[]` | ``enum (`https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet.BreakdownDimension`)`` The set of dimensions along which to break down the response; may be empty. If multiple dimensions are requested, the breakdown is along the Cartesian product of the requested dimensions. |
| Union field `time_range`. The time range for the filter set; can be specified as a relative date range, an absolute date range, or an open-ended real-time time range. `time_range` can be only one of the following: |||
| `relativeDateRange` | ``object (`https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet.RelativeDateRange`)`` A relative date range, defined by an offset from today and a duration. Interpreted relative to Pacific time zone. |
| `absoluteDateRange` | ``object (`https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet.AbsoluteDateRange`)`` An absolute date range, defined by a start date and an end date. Interpreted relative to Pacific time zone. |
| `realtimeTimeRange` | ``object (`https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet.RealtimeTimeRange`)`` An open-ended realtime time range, defined by the aggregation start timestamp. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.filterSets/create` | Creates the specified filter set for the account with the given account ID. |
| ### `https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.filterSets/delete` | Deletes the requested filter set from the account with the given account ID. |
| ### `https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.filterSets/get` | Retrieves the requested filter set for the account with the given account ID. |
| ### `https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/bidders.filterSets/list` | Lists all filter sets for the account with the given account ID. |