授权

Checks API 使用 OAuth 2.0 对请求进行授权。

OAuth 范围为 https://www.googleapis.com/auth/checks。

使用 OAuth 2.0 进行授权

本快速入门介绍了如何使用 gcloud CLI 通过服务账号授权请求。

设置 gcloud CLI

  1. 安装 gcloud CLI。

  2. 使用 gcloud CLI 登录并设置默认项目：

    gcloud auth login
gcloud config set project PROJECT_ID

  3. 创建服务账号和服务账号密钥，并设置应用默认凭据：

    gcloud iam service-accounts create SA_NAME
gcloud iam service-accounts keys create key.json \
    --iam-account=SA_NAME@PROJECT_ID.iam.gserviceaccount.com
export GOOGLE_APPLICATION_CREDENTIALS=key.json

向 Checks 账号授予 API 访问权限

API 调用者必须是 Checks 账号的用户，并且拥有适当的读取或写入权限。

  1. 前往 Checks 控制台中的设置页面，然后点击管理用户。

  2. 邀请您之前创建的服务账号：

    SA_NAME@PROJECT_ID.iam.gserviceaccount.com

查找您的账号 ID

您的 Checks 账号 ID 是账号资源请求的资源 ID。

例如，列出应用的 accounts.apps.list 方法具有以下格式：

https://checks.googleapis.com/v1alpha/accounts/ACCOUNT_ID/apps

您可以在 Checks 控制台的设置页面上的账号信息部分中找到您的账号 ID。

获取访问令牌

gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/checks

发出请求

curl -X GET \
    -H "X-Goog-User-Project: PROJECT_ID" \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/checks)" \
    "https://checks.googleapis.com/v1alpha/accounts/ACCOUNT_ID/apps"