W przypadku każdego nowego elementu zamówienia musisz zadeklarować, czy będzie on wyświetlać reklamy polityczne w Unii Europejskiej (UE). Przesyłanie plików SDF i interfejsu Display & Video 360 API, które nie zawierają deklaracji, zakończy się niepowodzeniem. Więcej informacji znajdziesz na naszej stronie dotyczącej wycofywania.
Wymagane. Identyfikator listy niestandardowej do pobrania.
Parametry zapytania
Parametry
Parametr zbiorczy accessor. Wymagane. Określa, w którym podmiocie DV360 jest wysyłane żądanie. Żądanie GET zwróci tylko elementy listy niestandardowej, które są dostępne dla elementu DV360 zidentyfikowanego w parametrze accessor. accessor może mieć tylko jedną z tych wartości:
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-09-10 UTC."],[[["\u003cp\u003eRetrieves a specific custom list using its ID via a GET request.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying an advertiser ID to identify the DV360 entity for access control.\u003c/p\u003e\n"],["\u003cp\u003eReturns the details of the custom list if the request is successful and authorized.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes gRPC Transcoding for URL syntax and necessitates an empty request body.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],["This document details how to retrieve a custom list using a GET request. The request URL requires the `customListId` as a path parameter. It also mandates the `accessor` union parameter, either `advertiserId`, as a query parameter to define the relevant DV360 entity. The request body must be empty. A successful request returns an instance of `CustomList` in the response body. The request requires `https://www.googleapis.com/auth/display-video` OAuth scope.\n"],null,["| Display \\& Video 360 API v3 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- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nGets a custom list.\n\nHTTP request\n\n`GET https://displayvideo.googleapis.com/v3/customLists/{customListId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\nPath 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\nQuery 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\nRequest body\n\nThe request body must be empty.\n\nResponse body\n\nIf successful, the response body contains an instance of [CustomList](/display-video/api/reference/rest/v3/customLists#CustomList).\n\nAuthorization 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)."]]
