Method: bidders.filterSets.create
Stay organized with collections
Save and categorize content based on your preferences.
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
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-09-18 UTC.
[null,null,["Last updated 2024-09-18 UTC."],[[["\u003cp\u003eCreates a new filter set for a specified bidder or account, allowing for customized filtering of impressions.\u003c/p\u003e\n"],["\u003cp\u003eFilter sets can be configured as transient for temporary use or persistent for ongoing application.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires providing the filter set details in the request body and specifying the owner (bidder or account) in the URL path.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful creation returns the details of the newly created filter set.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes the \u003ccode\u003ehttps://www.googleapis.com/auth/adexchange.buyer\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],["This outlines creating a filter set for a specified account using a `POST` request to `https://adexchangebuyer.googleapis.com/v2beta1/{ownerName=bidders/*}/filterSets`. The `ownerName` path parameter designates the filter set's owner (bidder or account). The `isTransient` query parameter defines if the filter set is temporary. The request body uses the `FilterSet` resource, and a successful response returns a new `FilterSet` instance. The process requires `https://www.googleapis.com/auth/adexchange.buyer` authorization scope.\n"],null,["# Method: bidders.filterSets.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates the specified filter set for the account with the given account ID.\n\n### HTTP request\n\n`POST https://adexchangebuyer.googleapis.com/v2beta1/{ownerName=bidders/*}/filterSets`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `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` |\n\n### Query parameters\n\n| Parameters ||\n|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `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. |\n\n### Request body\n\nThe request body contains an instance of [FilterSet](/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [FilterSet](/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets#FilterSet).\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/adexchange.buyer`"]]