Ab dem
8. September 2025 muss für jede neue Werbebuchung angegeben werden, ob Werbung mit politischen Inhalten in der Europäischen Union (EU) ausgeliefert wird. Display & Video 360 API- und SDF-Uploads ohne entsprechende Erklärungen schlagen fehl. Weitere Informationen dazu, wie Sie Ihre Integration aktualisieren, um diese Erklärung abzugeben,
finden Sie auf unserer Seite zur Einstellung.
Method: advertisers.locationLists.assignedLocations.list
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Listet Standorte auf, die einer Standortliste zugewiesen sind.
HTTP-Anfrage
GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
advertiserId |
string (int64 format)
Erforderlich. Die ID des DV360-Werbetreibenden, zu dem die Standortliste gehört.
|
locationListId |
string (int64 format)
Erforderlich. Die ID der Standortliste, der diese Zuweisungen zugewiesen sind.
|
Abfrageparameter
| Parameter |
pageSize |
integer
Angeforderte Seitengröße. Muss zwischen 1 und 200 liegen. Wenn nicht angegeben, wird standardmäßig 100 verwendet. Wenn ein ungültiger Wert angegeben wird, wird der Fehlercode INVALID_ARGUMENT zurückgegeben.
|
pageToken |
string
Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll. Normalerweise ist dies der Wert von nextPageToken, der vom vorherigen Aufruf der assignedLocations.list-Methode zurückgegeben wurde. Wenn keine Angabe erfolgt, wird die erste Ergebnisseite zurückgegeben.
|
orderBy |
string
Feld, nach dem die Liste sortiert werden soll. Akzeptable Werte sind:
assignedLocationId (Standard) Die Standardsortierreihenfolge ist aufsteigend. Wenn Sie ein Feld absteigend sortieren möchten, sollte dem Feldnamen das Suffix „desc“ hinzugefügt werden. Beispiel: assignedLocationId desc.
|
filter |
string
Es kann nach den Feldern für die Zuweisung von Standortlisten gefiltert werden. Unterstützte Syntax:
- Filterausdrücke bestehen aus einer oder mehreren Einschränkungen.
- Einschränkungen können mit dem logischen Operator
OR kombiniert werden.
- Eine Einschränkung hat das Format
{field} {operator} {value}.
- Für alle Felder muss der Operator
EQUALS (=) verwendet werden.
Unterstützte Felder:
Dieses Feld darf maximal 500 Zeichen lang sein. Weitere Informationen finden Sie in unserem Leitfaden zu LIST-Anfragen.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwortnachricht für AssignedLocationService.ListAssignedLocations
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"assignedLocations": [
{
object (AssignedLocation)
}
],
"nextPageToken": string
} |
| Felder |
assignedLocations[] |
object (AssignedLocation)
Die Liste der zugewiesenen Standorte. Wenn die Liste leer ist, ist sie nicht vorhanden.
|
nextPageToken |
string
Ein Token, mit dem die nächste Ergebnisseite abgerufen werden kann. Übergeben Sie diesen Wert im Feld pageToken im nachfolgenden Aufruf der Methode assignedLocations.list, um die nächste Ergebnisseite abzurufen.
|
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/display-video
Weitere Informationen finden Sie unter OAuth 2.0 Overview.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[],["This document outlines how to use the Display & Video 360 API v4's `assignedLocations.list` method to retrieve locations linked to a specific location list. It requires a GET request to a specified URL with path parameters for `advertiserId` and `locationListId`. Optional query parameters include `pageSize`, `pageToken`, `orderBy`, and `filter` for managing results. The API returns a list of `assignedLocations` and a `nextPageToken` if more results are available. OAuth 2.0 authorization with the `display-video` scope is needed.\n"],null,["# Method: advertisers.locationLists.assignedLocations.list\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 - [JSON representation](#body.ListAssignedLocationsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists locations assigned to a location list.\n\n### HTTP request\n\n`GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations`\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 DV360 advertiser to which the location list belongs. |\n| `locationListId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the location list to which these assignments are assigned. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Requested page size. Must be between `1` and `200`. If unspecified will default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is specified. |\n| `pageToken` | `string` A token identifying a page of results the server should return. Typically, this is the value of [nextPageToken](/display-video/api/reference/rest/v4/advertisers.locationLists.assignedLocations/list#body.ListAssignedLocationsResponse.FIELDS.next_page_token) returned from the previous call to `assignedLocations.list` 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: - `assignedLocationId` (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: `assignedLocationId desc`. |\n| `filter` | `string` Allows filtering by location list assignment 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: - `assignedLocationId` 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\nResponse message for AssignedLocationService.ListAssignedLocations.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"assignedLocations\": [ { object (/display-video/api/reference/rest/v4/advertisers.locationLists.assignedLocations#AssignedLocation) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `assignedLocations[]` | `object (`[AssignedLocation](/display-video/api/reference/rest/v4/advertisers.locationLists.assignedLocations#AssignedLocation)`)` The list of assigned locations. This list will be absent if empty. |\n| `nextPageToken` | `string` A token to retrieve the next page of results. Pass this value in the [pageToken](/display-video/api/reference/rest/v4/advertisers.locationLists.assignedLocations/list#body.QUERY_PARAMETERS.page_token) field in the subsequent call to `assignedLocations.list` method to retrieve the next page of results. |\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)."]]
