A partir del 8 de septiembre de 2025, cada elemento de la línea nuevo deberá declarar si publicará anuncios políticos de la Unión Europea (UE). Las cargas de la API de Display & Video 360 y del SDF que no proporcionen declaraciones fallarán. Consulta nuestra página de bajas para obtener más detalles sobre cómo actualizar tu integración y realizar esta declaración.
Es obligatorio. ID de la lista personalizada que se recuperará.
Parámetros de consulta
Parámetros
Parámetro de unión accessor. Es obligatorio. Identifica dentro de qué entidad de DV360 se realiza la solicitud. La solicitud GET solo devolverá entidades de listas personalizadas a las que se pueda acceder desde la entidad de DV360 identificada en accessor. accessor puede ser solo uno de los siguientes:
[null,null,["Última actualización: 2025-07-26 (UTC)"],[[["\u003cp\u003eThis document outlines how to get a custom list using the Display & Video 360 API.\u003c/p\u003e\n"],["\u003cp\u003eIt specifies the required HTTP request, path and query parameters, and authorization scope.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should be empty, and a successful response will contain a \u003ccode\u003eCustomList\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eYou need to identify the requesting DV360 entity using the \u003ccode\u003eaccessor\u003c/code\u003e query parameter (e.g., \u003ccode\u003eadvertiserId\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["The Display & Video 360 API v2 has been discontinued. To retrieve a specific custom list, a GET request is sent to `https://displayvideo.googleapis.com/v2/customLists/{customListId}`. The `customListId` is required as a path parameter, and the `accessor` (e.g., `advertiserId`) is needed as a query parameter. The request body must be empty. A successful response returns a `CustomList` instance. The request requires the `https://www.googleapis.com/auth/display-video` OAuth scope.\n"],null,["# Method: customLists.get\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- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nGets a custom list.\n\n### HTTP request\n\n`GET https://displayvideo.googleapis.com/v2/customLists/{customListId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|-----------------------------------------------------------------------------------------------------------------------------------|\n| `customListId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the custom list to fetch. |\n\n### Query parameters\n\n| Parameters ||\n|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Union parameter `accessor`. Required. Identifies which DV360 entity the request is being made within. The GET request will only return custom list entities that are accessible to the DV360 entity identified within the `accessor`. `accessor` can be only one of the following: ||\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the DV360 advertiser that has access to the fetched custom lists. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [CustomList](/display-video/api/reference/rest/v2/customLists#CustomList).\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)."]]
