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 advertisers.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 2024-09-18 UTC."],[[["\u003cp\u003eLists assigned targeting options for an advertiser, including details like targeting type and assigned values.\u003c/p\u003e\n"],["\u003cp\u003eSupports filtering by targeting type and sorting by relevant fields, allowing for customized retrieval of options.\u003c/p\u003e\n"],["\u003cp\u003eEnables pagination to retrieve large sets of assigned targeting options, ensuring efficient handling of extensive data.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope for access and data retrieval.\u003c/p\u003e\n"]]],["This document outlines the `bulkListAdvertiserAssignedTargetingOptions` method for retrieving assigned targeting options of an advertiser. It uses a `GET` request with `advertiserId` as a required path parameter. Optional query parameters include `pageSize`, `pageToken`, `orderBy`, and `filter`. The request body is empty. The successful response contains a list of `assignedTargetingOptions` and an optional `nextPageToken` for pagination. This method requires the `https://www.googleapis.com/auth/display-video` OAuth scope. The Display & Video 360 API v1 has been sunset.\n"],null,["# Method: advertisers.bulkListAdvertiserAssignedTargetingOptions\n\n| Display \\& Video 360 API v1 has been sunset.\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/v1/advertisers/{advertiserId}:bulkListAdvertiserAssignedTargetingOptions`\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/v1/advertisers/bulkListAdvertiserAssignedTargetingOptions#body.BulkListAdvertiserAssignedTargetingOptionsResponse.FIELDS.next_page_token) returned from the previous call to `advertisers.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/v1/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `assignedTargetingOptions[]` | `object (`[AssignedTargetingOption](/display-video/api/reference/rest/v1/advertisers.campaigns.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/v1/advertisers/bulkListAdvertiserAssignedTargetingOptions#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/v1/advertisers/bulkListAdvertiserAssignedTargetingOptions#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](https://developers.google.com/identity/protocols/OAuth2)."]]