授權

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
    

將 API 存取權授予 Checks 帳戶

API 呼叫端必須是 Checks 帳戶的使用者,並具備適當的讀取或寫入權限。

  1. 前往 Checks Console 的「Settings」頁面,然後按一下「Manage users」

  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 Console」部分,找到您的帳戶 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"

後續步驟

請參閱我們的「上傳」指南,瞭解如何上傳應用程式以進行分析。