试用 Google Analytics 的 MCP 服务器。从
GitHub 安装,并参阅
公告了解详情。
Method: properties.audienceExports.list
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
列出媒体资源的所有导出的受众群体。您可以使用此方法查找和重复使用现有的受众群体导出数据,而不是创建不必要的新受众群体导出数据。同一受众群体可以有多个受众群体导出,这些导出内容分别代表了在不同日期属于该受众群体的用户。
如需通过示例简要了解受众群体导出,请参阅创建受众群体导出。
受众群体导出 API 中的一些方法处于 Alpha 版阶段,其他方法处于 Beta 版阶段。目的是在收集一些反馈并获得一定程度的采用后,将方法推进到 Beta 版稳定性阶段。如需提供您对此 API 的反馈,请填写 Google Analytics Audience Export API 反馈表单。
HTTP 请求
GET https://analyticsdata.googleapis.com/v1beta/{parent=properties/*}/audienceExports
网址采用 gRPC 转码语法。
路径参数
参数 |
parent |
string
必需。响应中会列出此媒体资源的所有导出的受众群体。格式:properties/{property}
|
查询参数
参数 |
pageSize |
integer
可选。要返回的受众群体导出的最大数量。服务返回的值可能小于此值。如果未指定,则最多返回 200 个受众群体导出。最大值为 1,000(更高的值将被强制转换为最大值)。
|
pageToken |
string
可选。从之前的 audienceExports.list 调用接收的页面令牌。利用其进行后续页面检索。 进行分页时,提供给 audienceExports.list 的所有其他参数必须与提供页面令牌的调用匹配。
|
响应正文
媒体资源的所有导出受众群体的列表。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
{
"audienceExports": [
{
object (AudienceExport )
}
],
"nextPageToken": string
} |
字段 |
audienceExports[] |
object (AudienceExport )
媒体资源的每次受众群体导出。
|
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 audience exports for a given Google Analytics property, allowing for reuse of existing exports.\u003c/p\u003e\n"],["\u003cp\u003eProvides pagination to retrieve large lists of audience exports with \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e parameters.\u003c/p\u003e\n"],["\u003cp\u003eReturns an array of \u003ccode\u003eAudienceExport\u003c/code\u003e objects containing details about each export.\u003c/p\u003e\n"],["\u003cp\u003eRequires \u003ccode\u003eanalytics.readonly\u003c/code\u003e or \u003ccode\u003eanalytics\u003c/code\u003e OAuth scopes for authorization.\u003c/p\u003e\n"],["\u003cp\u003eOffers alpha and beta stability for different methods within the API, encouraging user feedback for improvement.\u003c/p\u003e\n"]]],["This document details how to list audience exports for a given property using the Google Analytics Data API. Key actions include sending a `GET` request to a specified URL with a property identifier (`parent`) as a path parameter. Optional query parameters like `pageSize` and `pageToken` allow for controlling the number of results and pagination. The request body should be empty. The response returns a list of audience exports and a token for accessing further pages. Authorization requires specific OAuth scopes.\n"],null,["# Method: properties.audienceExports.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.ListAudienceExportsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists all audience exports for a property. This method can be used for you to find and reuse existing audience exports rather than creating unnecessary new audience exports. The same audience can have multiple audience exports that represent the export of users that were in an audience on different days.\n\nSee [Creating an Audience Export](https://developers.google.com/analytics/devguides/reporting/data/v1/audience-list-basics) for an introduction to Audience Exports with examples.\n\nAudience Export APIs have some methods at alpha and other methods at beta stability. The intention is to advance methods to beta stability after some feedback and adoption. 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/v1beta/{parent=properties/*}/audienceExports`\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 audience exports 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 audience exports to return. The service may return fewer than this value. If unspecified, at most 200 audience exports 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 `audienceExports.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `audienceExports.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 audience exports for a property.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"audienceExports\": [ { object (/analytics/devguides/reporting/data/v1/rest/v1beta/properties.audienceExports#AudienceExport) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `audience``Exports[]` | `object (`[AudienceExport](/analytics/devguides/reporting/data/v1/rest/v1beta/properties.audienceExports#AudienceExport)`)` Each audience export 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`"]]