列出媒体资源的所有受众群体名单。通过此方法,您可以查找和重复使用现有的受众群体名单,而无需创建不必要的新受众群体名单。同一受众群体可以有多个受众群体名单,分别代表不同日期属于同一受众群体的用户。
如需通过示例了解受众群体名单,请参阅创建受众群体名单。
此方法在 Beta 版稳定性阶段可用,位于 audienceExports.list。如需就此 API 提供反馈,请填写 Google Analytics Audience Export API 反馈表单。
HTTP 请求
GET https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
parent |
必需。此媒体资源的所有受众群体名单都会列在响应中。格式: |
查询参数
参数 | |
---|---|
pageSize |
可选。要返回的受众群体名单数量上限。服务返回的值可能小于此值。如果未指定,则最多返回 200 个受众群体名单。最大值为 1000(值越大,将被强制转换为最大值)。 |
pageToken |
可选。从之前的 进行分页时,提供给 |
请求正文
请求正文必须为空。
响应正文
包含媒体资源的所有受众群体名单的列表。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"audienceLists": [
{
object ( |
字段 | |
---|---|
audienceLists[] |
媒体资源的每个受众群体名单。 |
nextPageToken |
可作为 |
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics