本頁面由 Cloud Translation API 翻譯而成。

API 快速入門導覽課程：使用指令列

本頁將說明如何使用 Google Analytics Data API v1 互動

步驟 1：啟用 API

點選以下按鈕，即可自動建立新的 Google Cloud 專案啟用 Google Analytics Data API v1，並建立此專案所需的 OAuth2 憑證教學課程：

系統會自動將您重新導向至 OAuth2 憑證設定對話方塊當對話方塊詢問「您是從哪裡撥打電話？」時，請選擇電腦：

在出現的對話方塊中，按一下「下載用戶端設定」並儲存檔案 credentials.json 至工作目錄。

您也可以按照這些步驟建立 OAuth2 現有憑證專案。

步驟 2：安裝並初始化 Cloud SDK

您需要使用 gcloud 指令列安裝在開發機器上

步驟 3：發出 API 呼叫

您現在可以使用 Google Analytics Data API 查詢 Google Analytics 資源。

選取檢舉實體

在這個教學課程中，我們會使用環境變數 GA_PROPERTY_ID 儲存要在 API 要求中使用的資源 ID。

在指令列中輸入下列指令，設定 GA_PROPERTY_ID 變數：

export GA_PROPERTY_ID=[YOUR_GA_PROPERTY_ID]

將 [YOUR_GA_PROPERTY_ID] 替換為 Google Analytics 資源 ID：例如：

export GA_PROPERTY_ID=1234567890

建立要求 JSON

下列 request.json 檔案示範如何建立簡易報表。

使用下列文字建立 JSON 要求檔案，並儲存為工作目錄中的 request.json 純文字檔案：

request.json

{
  "dateRanges": [{ "startDate": "2020-09-01", "endDate": "2020-09-15" }],
  "dimensions": [{ "name": "country" }],
  "metrics": [{ "name": "activeUsers" }]
}

驗證

如要取得這個範例中的使用者憑證，請執行以下指令，並使用您在步驟 1 下載的憑證 JSON 檔案的路徑：

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

系統會在新的瀏覽器視窗中開啟 OAuth 使用者同意對話方塊。

傳送要求

使用 curl 和 request.json 中的主體內容，將要求傳送至 Google Analytics Data API。在指令列中輸入以下指令：

  curl -X POST \
  -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
  -H "Content-Type: application/json; charset=utf-8" \
  https://analyticsdata.googleapis.com/v1beta/properties/$GA_PROPERTY_ID:runReport -d @request.json

curl 指令使用 gcloud auth application-default print-access-token 取得驗證權杖。

請注意，如要將檔案名稱傳送給 curl，請使用 -d 選項 (用於「資料」) 並並在檔案名稱前面加上 @ 符號。這個檔案必須位於相同目錄中並在這個環境中執行 curl 指令