Bắt đầu nhanh API bằng dòng lệnh

Trang này cho bạn biết cách bắt đầu sử dụng Google Analytics Data API phiên bản 1 bằng lệnh .

Bước 1. Bật API

Nhấp vào nút sau đây để tự động tạo một dự án Google Cloud mới bật Google Analytics Data API v1 và tạo thông tin đăng nhập OAuth2 cần thiết cho việc này hướng dẫn:

Bật Google Analytics Data API phiên bản 1

Bạn sẽ được tự động chuyển hướng đến phần định cấu hình thông tin đăng nhập OAuth2 . Khi hộp thoại hỏi Bạn đang gọi từ đâu?, hãy chọn Máy tính.

Trong hộp thoại hiện ra, hãy nhấp vào DOWNLOAD CLIENT CONFIGURATION (Tải cấu hình ứng dụng xuống) rồi lưu tệp credentials.json vào thư mục đang làm việc của bạn.

Ngoài ra, bạn có thể làm theo các bước này để tạo OAuth2 Thông tin đăng nhập trong một dự án theo cách thủ công.

Bước 2. Cài đặt và khởi chạy Cloud SDK

Bạn cần dòng lệnh gcloud công cụ được cài đặt trên máy phát triển của bạn.

Bước 3: Thực hiện lệnh gọi API

Giờ đây, bạn có thể sử dụng Google Analytics Data API để truy vấn một Google Analytics thuộc tính này.

Chọn một pháp nhân báo cáo

Trong hướng dẫn này, chúng ta sẽ sử dụng biến môi trường GA_PROPERTY_ID để lưu trữ mã thuộc tính sẽ được sử dụng trong các yêu cầu API.

Nhập nội dung sau vào dòng lệnh để đặt biến GA_PROPERTY_ID:

export GA_PROPERTY_ID=[YOUR_GA_PROPERTY_ID]

Thay thế [YOUR_GA_PROPERTY_ID] bằng tài sản Google Analytics mã nhận dạng. Ví dụ:

export GA_PROPERTY_ID=1234567890

Tạo JSON yêu cầu

Tệp request.json sau đây minh hoạ cách tạo một báo cáo đơn giản.

Tạo tệp yêu cầu JSON có nội dung sau đây rồi lưu dưới dạng request.json tệp văn bản thuần tuý trong thư mục đang làm việc của bạn:

request.json

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

Xác thực

Để lấy thông tin đăng nhập của người dùng trong ví dụ này, hãy chạy lệnh sau và sử dụng đường dẫn đến tệp JSON chứa thông tin đăng nhập được tải xuống ở Bước 1:

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

Hộp thoại đồng ý của người dùng OAuth sẽ mở trong cửa sổ trình duyệt mới.

Gửi yêu cầu

Sử dụng curl và nội dung nội dung từ request.json để gửi yêu cầu đến API Dữ liệu của Google Analytics. Nhập nội dung sau vào dòng lệnh:

  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

Lệnh curl sử dụng gcloud auth application-default print-access-token để nhận mã thông báo xác thực.

Lưu ý rằng để chuyển tên tệp vào curl, bạn sử dụng tuỳ chọn -d (đối với "data") và đặt trước tên tệp bằng ký hiệu @. Tệp này phải nằm trong cùng một thư mục trong đó bạn thực thi lệnh curl.