快速入门:使用命令行

本页介绍了如何通过命令行开始使用 Google Analytics Admin API。

第 1 步:启用 API

点击此按钮即可创建一个新的 Cloud Platform 项目,自动启用 Google Analytics Admin API,并创建本教程所需的 OAuth2 凭据:

启用 Google Analytics(分析)Admin API

系统会自动将您重定向到 OAuth2 凭据配置对话框。当系统询问“您是从哪里打电话?”时,选择“桌面设备”。

在出现的对话框中,点击下载客户端配置,并将文件 credentials.json 保存到您的工作目录中。

或者,您也可以按照相关步骤在现有项目中手动创建 OAuth2 凭据

第 2 步:安装并初始化 Cloud SDK

您需要在开发机器上安装 gcloud 命令行工具。

第 3 步:进行 API 调用

现在,您可以使用 Google Analytics Admin API 来查询 Google Analytics(分析)4 媒体资源。

身份验证

如需在此示例中获取用户凭据,请运行以下命令,并使用在第 1 步下载的凭据 JSON 文件的路径:

gcloud auth application-default login \
    --scopes=https://www.googleapis.com/auth/analytics.readonly \
    --client-id-file=[PATH/TO/credentials.json]

系统会在新的浏览器窗口中打开 OAuth 用户意见征求对话框。

发送请求

使用 curl 向 Google Analytics Admin API 发送请求。在命令行中输入以下内容:

  curl \
  -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
  -H "Content-Type: application/json; charset=utf-8" \
  https://analyticsadmin.googleapis.com/v1beta/accounts

curl 命令使用 gcloud auth application-default print-access-token 命令获取身份验证令牌。

恭喜!您已向 Google Analytics(分析)Admin API 发送了您的第一个请求。