自
2025 年 9 月 8 日起,每个新订单项都需要声明是否会投放欧盟 (EU) 政治广告。Display & Video 360 API 和未提供声明的 SDF 上传操作将会失败。如需详细了解如何更新集成以进行此声明,请参阅我们的
弃用页面。
REST Resource: customLists
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
资源:CustomList
用于描述自定义名单实体,例如自定义的兴趣相似受众群体名单或自定义的意向受众群体名单。
JSON 表示法 |
{
"name": string,
"customListId": string,
"displayName": string
} |
字段 |
name |
string
仅限输出。自定义列表的资源名称。
|
customListId |
string (int64 format)
仅限输出。自定义列表的唯一 ID。由系统分配。
|
displayName |
string
仅限输出。自定义列表的显示名称。。
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\u003cp\u003eThe CustomList resource represents custom entities like affinity or intent audience lists, defined by a unique ID, name, and display name.\u003c/p\u003e\n"],["\u003cp\u003eThis resource can be managed through methods for retrieval (get) and listing (list), accessible via the provided API endpoints.\u003c/p\u003e\n"],["\u003cp\u003eThe JSON representation of a CustomList includes fields for name, customListId (unique identifier), and displayName.\u003c/p\u003e\n"]]],["The `CustomList` resource represents a custom entity like an audience list. It has a `name`, a system-assigned `customListId`, and a `displayName`. These fields are read-only. The resource offers two methods: `get`, which retrieves a specific custom list, and `list`, which retrieves a collection of custom lists. The `CustomList` data can be represented in a JSON format containing these three attributes.\n"],null,["# REST Resource: customLists\n\n| Display \\& Video 360 API 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- [Resource: CustomList](#CustomList)\n - [JSON representation](#CustomList.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: CustomList\n--------------------\n\nDescribes a custom list entity, such as a custom affinity or custom intent audience list.\n\n| JSON representation |\n|---------------------------------------------------------------------------|\n| ``` { \"name\": string, \"customListId\": string, \"displayName\": string } ``` |\n\n| Fields ||\n|----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. The resource name of the custom list. |\n| `customListId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The unique ID of the custom list. Assigned by the system. |\n| `displayName` | `string` Output only. The display name of the custom list. . |\n\n| Methods ------- ||\n|-------------------------------------------------------------------|---------------------|\n| ### [get](/display-video/api/reference/rest/v3/customLists/get) | Gets a custom list. |\n| ### [list](/display-video/api/reference/rest/v3/customLists/list) | Lists custom lists. |"]]