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.
Erforderlich. Die ID des DV360-Werbetreibenden, zu dem die abgerufenen Listen mit auszuschließenden Keywords gehören.
Abfrageparameter
Parameter
pageSize
integer
Angeforderte Seitengröße. Muss zwischen 1 und 200 liegen. Wenn kein Wert festgelegt ist, wird der Standardwert 100 verwendet. Gibt den Fehlercode INVALID_ARGUMENT zurück, wenn ein ungültiger Wert angegeben ist.
pageToken
string
Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll.
In der Regel ist dies der Wert von nextPageToken, der vom vorherigen Aufruf der Methode negativeKeywordLists.list zurückgegeben wurde. Wenn keine Angabe erfolgt, wird die erste Ergebnisseite zurückgegeben.
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwortnachricht für NegativeKeywordListService.ListNegativeKeywordLists
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[[["\u003cp\u003eThis document details the \u003ccode\u003enegativeKeywordLists.list\u003c/code\u003e method, which retrieves negative keyword lists for a specific advertiser within Display & Video 360.\u003c/p\u003e\n"],["\u003cp\u003eThe API request requires an advertiser ID and accepts optional parameters for pagination, such as \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful responses provide a list of negative keyword lists associated with the specified advertiser and a token for retrieving subsequent pages if available.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this method necessitates the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: advertisers.negativeKeywordLists.list\n\n| Display \\& Video 360 API v2 has 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.ListNegativeKeywordListsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists negative keyword lists based on a given advertiser id.\n\n### HTTP request\n\n`GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/negativeKeywordLists`\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 fetched negative keyword lists belong. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Requested page size. Must be between `1` and `200`. Defaults to `100` if not set. 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/v2/advertisers.negativeKeywordLists/list#body.ListNegativeKeywordListsResponse.FIELDS.next_page_token) returned from the previous call to `negativeKeywordLists.list` method. If not specified, the first page of results will be returned. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for NegativeKeywordListService.ListNegativeKeywordLists.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"negativeKeywordLists\": [ { object (/display-video/api/reference/rest/v2/advertisers.negativeKeywordLists#NegativeKeywordList) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|--------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `negativeKeywordLists[]` | `object (`[NegativeKeywordList](/display-video/api/reference/rest/v2/advertisers.negativeKeywordLists#NegativeKeywordList)`)` The list of negative keyword lists. 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/v2/advertisers.negativeKeywordLists/list#body.QUERY_PARAMETERS.page_token) field in the subsequent call to `negativeKeywordLists.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](https://developers.google.com/identity/protocols/OAuth2)."]]
