使用Management API时，如何列出Google Analytics所有非抽样报告ID？

云上老周

2026-5-27

如何列出Google Analytics非抽样报告的ID

嘿，要拿到所有非抽样报告的ID，用Google Analytics Management API的unsampledReports.list方法就搞定了，我给你拆解下具体怎么做：

1. 先搞定API权限和认证

首先得确保你的Google Cloud项目已经启用了Google Analytics Management API，而且你的账号得有足够权限（比如analytics.readonly权限就够读取报告了）。
必须用OAuth 2.0获取访问令牌，这是调用所有GA API的必要前提——毕竟要验证你有权访问对应的GA资源嘛。

2. 调用`unsampledReports.list`端点

这个API端点的格式是：

GET https://analytics.googleapis.com/analytics/v3/management/accounts/{accountId}/webproperties/{webPropertyId}/profiles/{profileId}/unsampledReports

关键参数说明：

accountId: 你的GA账号ID，去GA后台的「管理员」面板里就能找到。
webPropertyId: 对应的媒体资源ID，格式一般是UA-XXXXXXXXX-X，同样在管理员面板的媒体资源设置里看。
profileId: 视图（View）ID，还是在管理员面板的视图部分能查到。

举个curl请求的例子：

curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  "https://analytics.googleapis.com/analytics/v3/management/accounts/123456/webproperties/UA-12345678-9/profiles/987654/unsampledReports"

3. 从响应里提取ID

API返回的是JSON格式的数据，里面的items数组里每一项都是一个非抽样报告，其中的id字段就是你要找的报告ID。大概的响应结构长这样：

{
  "kind": "analytics#unsampledReports",
  "items": [
    {
      "id": "abc123xyz789",
      "title": "Q3 2024 Unsampled Traffic Report",
      "status": "COMPLETED",
      // 其他诸如创建时间、存储位置等信息
    }
  ]
}