Kể từ ngày 8 tháng 9 năm 2025, mỗi mục hàng mới sẽ cần phải khai báo xem mục hàng đó có phân phát quảng cáo chính trị ở Liên minh Châu Âu (EU) hay không. Display & Video 360 API và các tệp SDF được tải lên mà không cung cấp thông tin khai báo sẽ không thành công. Hãy xem trang thông báo về những nội dung không dùng nữa để biết thêm thông tin về cách cập nhật quy trình tích hợp để đưa ra nội dung khai báo này.
Bắt buộc. Mã nhận dạng của danh sách tuỳ chỉnh cần tìm nạp.
Tham số truy vấn
Thông số
Tham số hợp nhất accessor. Bắt buộc. Xác định thực thể DV360 mà yêu cầu đang được thực hiện trong đó. Yêu cầu GET sẽ chỉ trả về các thực thể danh sách tuỳ chỉnh mà thực thể DV360 được xác định trong accessor có thể truy cập. accessor chỉ có thể là một trong những trạng thái sau:
[null,null,["Cập nhật lần gần đây nhất: 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)."]]
