Method: bidders.filterSets.create

  • This page details how to create a filter set for a given account ID.

  • Creating a filter set uses a POST HTTP request to the specified URL.

  • Path parameters like ownerName are used to identify the owner of the filter set.

  • Query parameters like isTransient determine if the filter set is temporary or permanent.

  • The request and response bodies both contain an instance of FilterSet.

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