试用 Google Analytics 的 MCP 服务器。从
GitHub 安装,并参阅
公告了解详情。
Method: properties.recurringAudienceLists.create
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
创建周期性受众群体名单。定期重复的受众群体名单每天都会生成新的受众群体名单。受众群体名单是创建名单时相应受众群体中的用户。
使用周期性受众群体名单可确保您的受众群体名单基于每天可用的最新数据。如果您手动创建受众群体名单,您将不知道根据未来一天的数据生成的受众群体名单何时可用。此定期重复的受众群体名单会在新增一天的数据时自动创建受众群体名单。与在一天的不同时段手动创建受众群体名单相比,尝试猜测新增一天的数据何时可以准备就绪,您可以减少消耗的配额令牌。
此方法是在 Alpha 版稳定性阶段推出的,目的是在进入 Beta 版之前收集有关语法和功能的反馈。如需就此 API 提供反馈,请填写 Google Analytics Audience Export API 反馈表单。
HTTP 请求
POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/recurringAudienceLists
网址采用 gRPC 转码语法。
路径参数
参数 |
parent |
string
必需。将在其中创建此周期性受众群体名单的父级资源。格式:properties/{property}
|
响应正文
如果成功,响应正文将包含一个新创建的 RecurringAudienceList
实例。
授权范围
需要以下 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\u003eCreates recurring audience lists daily, ensuring the most recent data is available for use.\u003c/p\u003e\n"],["\u003cp\u003eAutomates audience list creation, reducing manual effort and quota token consumption.\u003c/p\u003e\n"],["\u003cp\u003eIntroduced at alpha stability, seeking feedback through a provided form.\u003c/p\u003e\n"],["\u003cp\u003eUses an HTTP POST request to create recurring audience lists under a specified property.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific OAuth scopes for authorization.\u003c/p\u003e\n"]]],["This content details how to create a recurring audience list via an API. Key actions include sending a `POST` request to a specific URL (`https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/recurringAudienceLists`). The request requires a `parent` path parameter indicating the property. The request body contains the `RecurringAudienceList` instance, and upon success, the response body returns a newly created `RecurringAudienceList`. This automated list generation uses less quota and ensures the use of the most recent data available. The use of certain authorization scopes are required.\n"],null,["# Method: properties.recurringAudienceLists.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a recurring audience list. Recurring audience lists produces new audience lists each day. Audience lists are users in an audience at the time of the list's creation.\n\nA recurring audience list ensures that you have audience list based on the most recent data available for use each day. If you manually create audience list, you don't know when an audience list based on an additional day's data is available. This recurring audience list automates the creation of an audience list when an additional day's data is available. You will consume fewer quota tokens by using recurring audience list versus manually creating audience list at various times of day trying to guess when an additional day's data is ready.\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`POST 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. The parent resource where this recurring audience list will be created. Format: `properties/{property}` |\n\n### Request body\n\nThe request body contains an instance of [RecurringAudienceList](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.recurringAudienceLists#RecurringAudienceList).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [RecurringAudienceList](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.recurringAudienceLists#RecurringAudienceList).\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`"]]