Method: bidders.filterSets.create

  • Creates a new filter set for a specified bidder or account, allowing for customized filtering of impressions.

  • Filter sets can be configured as transient for temporary use or persistent for ongoing application.

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

  • Successful creation returns the details of the newly created filter set.

  • Utilizes the https://www.googleapis.com/auth/adexchange.buyer OAuth scope for authorization.

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

HTTP request

POST https://adexchangebuyer.googleapis.com/v2beta1/{ownerName=bidders/*}/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