Starting September 8, 2025, every new line item will need to declare whether or not they will serve Eurpoean Union (EU) political ads. Display & Video 360 API and SDF uploads that don't provide declarations will fail. See our deprecations page for more details on how to update your integration to make this declaration.
Required. The ID of the advertiser the line item belongs to.
Query parameters
Parameters
pageSize
integer
Requested page size. The size must be an integer between 1 and 5000. If unspecified, the default is '5000'. Returns error code INVALID_ARGUMENT if an invalid value is specified.
pageToken
string
A token that lets the client fetch the next page of results. Typically, this is the value of nextPageToken returned from the previous call to BulkListAdvertiserAssignedTargetingOptions method. If not specified, the first page of results will be returned.
orderBy
string
Field by which to sort the list. Acceptable values are:
targetingType (default)
The default sorting order is ascending. To specify descending order for a field, a suffix "desc" should be added to the field name. Example: targetingType desc.
filter
string
Allows filtering by assigned targeting option fields.
Supported syntax:
Filter expressions are made up of one or more restrictions.
Restrictions can be combined by the OR logical operator.
A restriction has the form of {field} {operator} {value}.
All fields must use the EQUALS (=) operator.
Supported fields:
targetingType
Examples:
targetingType with value TARGETING_TYPE_CHANNEL targetingType="TARGETING_TYPE_CHANNEL"
The length of this field should be no more than 500 characters.
A token identifying the next page of results. This value should be specified as the pageToken in a subsequent BulkListAdvertiserAssignedTargetingOptionsRequest to fetch the next page of results. This token will be absent if there are no more assignedTargetingOptions to return.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-04-02 UTC."],[[["\u003cp\u003eLists assigned targeting options for an advertiser across various targeting types.\u003c/p\u003e\n"],["\u003cp\u003eThe API request uses a \u003ccode\u003eGET\u003c/code\u003e method with the advertiser ID as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eResults can be filtered by targeting type and ordered by specified fields, with pagination supported via \u003ccode\u003epageToken\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of assigned targeting options and a token for retrieving subsequent pages.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This document details how to retrieve a list of an advertiser's assigned targeting options. The `GET` request utilizes a URL with the advertiser's ID as a path parameter. Optional query parameters like `pageSize`, `pageToken`, `orderBy`, and `filter` allow for pagination, sorting, and filtering. The request body must be empty, while a successful response contains an array of `assignedTargetingOptions` and a `nextPageToken` for further pagination. Access requires specific authorization scope.\n"],null,["# Method: advertisers.listAssignedTargetingOptions\n\n| Display \\& Video 360 API is deprecated and will sunset on **October 7, 2025** . Migrate to [Display \\& Video 360 API v4](/display-video/api/reference/rest/v4) before sunset to avoid an interruption in service.\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 - [JSON representation](#body.BulkListAdvertiserAssignedTargetingOptionsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists assigned targeting options of an advertiser across targeting types.\n\n### HTTP request\n\n`GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}:listAssignedTargetingOptions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the advertiser the line item belongs to. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Requested page size. The size must be an integer between `1` and `5000`. If unspecified, the default is '5000'. Returns error code `INVALID_ARGUMENT` if an invalid value is specified. |\n| `pageToken` | `string` A token that lets the client fetch the next page of results. Typically, this is the value of [nextPageToken](/display-video/api/reference/rest/v3/advertisers/listAssignedTargetingOptions#body.BulkListAdvertiserAssignedTargetingOptionsResponse.FIELDS.next_page_token) returned from the previous call to `BulkListAdvertiserAssignedTargetingOptions` method. If not specified, the first page of results will be returned. |\n| `orderBy` | `string` Field by which to sort the list. Acceptable values are: - `targetingType` (default) The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. Example: `targetingType desc`. |\n| `filter` | `string` Allows filtering by assigned targeting option fields. Supported syntax: - Filter expressions are made up of one or more restrictions. - Restrictions can be combined by the `OR` logical operator. - A restriction has the form of `{field} {operator} {value}`. - All fields must use the `EQUALS (=) operator`. Supported fields: - `targetingType` Examples: - targetingType with value TARGETING_TYPE_CHANNEL `targetingType=\"TARGETING_TYPE_CHANNEL\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"assignedTargetingOptions\": [ { object (/display-video/api/reference/rest/v3/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `assignedTargetingOptions[]` | `object (`[AssignedTargetingOption](/display-video/api/reference/rest/v3/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption)`)` The list of assigned targeting options. This list will be absent if empty. |\n| `nextPageToken` | `string` A token identifying the next page of results. This value should be specified as the [pageToken](/display-video/api/reference/rest/v3/advertisers/listAssignedTargetingOptions#body.QUERY_PARAMETERS.page_token) in a subsequent `BulkListAdvertiserAssignedTargetingOptionsRequest` to fetch the next page of results. This token will be absent if there are no more [assignedTargetingOptions](/display-video/api/reference/rest/v3/advertisers/listAssignedTargetingOptions#body.BulkListAdvertiserAssignedTargetingOptionsResponse.FIELDS.assigned_targeting_options) to return. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/display-video`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]