Method: bidders.accounts.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/*/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
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 filter set for a specified bidder or account, allowing for filtering of impressions in the ad exchange.\u003c/p\u003e\n"],["\u003cp\u003eFilter sets can be transient (temporary) or persisted indefinitely, and are accessible for at least an hour after creation.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires specifying the owner (bidder or account) in the URL path and providing filter set details in the request body.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful requests will receive a response containing the newly created filter set details.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/adexchange.buyer\u003c/code\u003e scope.\u003c/p\u003e\n"]]],[],null,["# Method: bidders.accounts.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/*/accounts/*}/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`"]]