试用 Google Analytics 的 MCP 服务器。从
GitHub 安装,并参阅
公告了解详情。
Method: properties.recurringAudienceLists.list
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
列出媒体资源的所有周期性受众群体名单。您可以使用此方法查找和重复使用现有的周期性受众群体名单,而不是创建不必要的新周期性受众群体名单。同一受众群体可以有多个周期性受众群体名单,这些名单代表不同的维度组合;例如,仅包含维度 deviceId
,或同时包含维度 deviceId
和 userId
。
此方法是在 Alpha 版稳定性阶段推出的,目的是在进入 Beta 版之前收集有关语法和功能的反馈。如需提供您对此 API 的反馈,请填写 Google Analytics Audience Export API 反馈表单。
HTTP 请求
GET https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/recurringAudienceLists
网址采用 gRPC 转码语法。
路径参数
参数 |
parent |
string
必需。响应中会列出此媒体资源的所有周期性受众群体名单。格式:properties/{property}
|
查询参数
参数 |
pageSize |
integer
可选。要返回的周期性受众群体名单的数量上限。服务返回的值可能小于此值。如果未指定,则最多返回 200 个周期性受众群体名单。最大值为 1,000(更高的值将被强制转换为最大值)。
|
pageToken |
string
可选。从之前的 recurringAudienceLists.list 调用接收的页面令牌。利用其进行后续页面检索。 进行分页时,提供给 recurringAudienceLists.list 的所有其他参数必须与提供页面令牌的调用匹配。
|
响应正文
媒体资源的所有周期性受众群体名单的列表。
如果成功,响应正文将包含结构如下的数据:
字段 |
recurringAudienceLists[] |
object (RecurringAudienceList )
媒体资源的每个周期性受众群体名单。
|
nextPageToken |
string
可作为 pageToken 发送并用于检索下一页的令牌。如果省略此字段,则不存在后续页面。
|
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-26。
[null,null,["最后更新时间 (UTC):2025-07-26。"],[[["\u003cp\u003eLists all recurring audience lists for a given Google Analytics property, allowing for reuse of existing lists.\u003c/p\u003e\n"],["\u003cp\u003eEnables finding audience lists with different dimension combinations (e.g., deviceId, userId).\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination to retrieve large numbers of recurring audience lists.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific authorization scopes for access.\u003c/p\u003e\n"],["\u003cp\u003eCurrently in alpha, with a feedback form available for user input.\u003c/p\u003e\n"]]],["This document details how to list recurring audience lists for a property using the Google Analytics Audience Export API. The API uses a `GET` request to a specified URL with the property ID as a path parameter. Optional query parameters (`pageSize`, `pageToken`) manage pagination. The request body is empty. The response is a JSON object containing an array of recurring audience lists and a `nextPageToken` for further pagination, if required. Authorization requires specific OAuth scopes.\n"],null,["# Method: properties.recurringAudienceLists.list\n\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.ListRecurringAudienceListsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists all recurring audience lists for a property. This method can be used for you to find and reuse existing recurring audience lists rather than creating unnecessary new recurring audience lists. The same audience can have multiple recurring audience lists that represent different dimension combinations; for example, just the dimension `deviceId` or both the dimensions `deviceId` and `userId`.\n\nThis method is introduced at alpha stability with the intention of gathering feedback on syntax and capabilities before entering beta. To give your feedback on this API, complete the [Google Analytics Audience Export API Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.\n\n### HTTP request\n\n`GET https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/recurringAudienceLists`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-----------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. All recurring audience lists for this property will be listed in the response. Format: `properties/{property}` |\n\n### Query parameters\n\n| Parameters ||\n|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `page``Size` | `integer` Optional. The maximum number of recurring audience lists to return. The service may return fewer than this value. If unspecified, at most 200 recurring audience lists will be returned. The maximum value is 1000 (higher values will be coerced to the maximum). |\n| `page``Token` | `string` Optional. A page token, received from a previous `recurringAudienceLists.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `recurringAudienceLists.list` must match the call that provided the page token. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA list of all recurring audience lists for a property.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"recurringAudienceLists\": [ { object (/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.recurringAudienceLists#RecurringAudienceList) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|--------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `recurring``Audience``Lists[]` | `object (`[RecurringAudienceList](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.recurringAudienceLists#RecurringAudienceList)`)` Each recurring audience list for a property. |\n| `next``Page``Token` | `string` A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/analytics.readonly`\n- `https://www.googleapis.com/auth/analytics`"]]