Method: bidders.accounts.filterSets.create

  • Creates a filter set for a specified bidder or account, allowing for filtering of impressions in the ad exchange.

  • Filter sets can be transient (temporary) or persisted indefinitely, and are accessible for at least an hour after creation.

  • The request requires specifying the owner (bidder or account) in the URL path and providing filter set details in the request body.

  • Successful requests will receive a response containing the newly created filter set details.

  • Authorization requires the https://www.googleapis.com/auth/adexchange.buyer scope.

Creates the specified filter set for the account with the given account ID.

HTTP request

POST https://adexchangebuyer.googleapis.com/v2beta1/{ownerName=bidders/*/accounts/*}/filterSets

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
ownerName

string

Name of the owner (bidder or account) of the filter set to be created. For example:

  • For a bidder-level filter set for bidder 123: bidders/123

  • For an account-level filter set for the buyer account representing bidder 123: bidders/123/accounts/123

  • For an account-level filter set for the child seat buyer account 456 whose bidder is 123: bidders/123/accounts/456

Query parameters

Parameters
isTransient

boolean

Whether the filter set is transient, or should be persisted indefinitely. By default, filter sets are not transient. If transient, it will be available for at least 1 hour after creation.

Request body

The request body contains an instance of FilterSet.

Response body

If successful, the response body contains a newly created instance of FilterSet.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/adexchange.buyer