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 cách sử dụng dòng lệnh.

Bước 1. Bật API

Nhấp vào nút này để tạo một dự án Cloud Platform mới, tự động bật API Dữ liệu Google Analytics phiên bản 1 và tạo thông tin đăng nhập OAuth2 cần thiết cho hướng dẫn này:

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

Bạn sẽ tự động được chuyển hướng đến hộp thoại cấu hình thông tin xác thực OAuth2. Chọn "Máy tính" khi được hỏi "Bạn đang gọi từ đâu?"

Trong hộp thoại thu được, hãy nhấp vào TẢI XUỐNG CẤU cấu hình ứng dụng rồi lưu tệp credentials.json vào thư mục đang làm việc.

Ngoài ra, bạn có thể làm theo các bước sau để tạo Thông tin xác thực OAuth2 trong một dự án hiện có theo cách thủ công.

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

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

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 tài sản Google Analytics 4.

Chọn một đối tượng báo cáo

Trong hướng dẫn này, chúng tôi sẽ sử dụng biến môi trường GA4_PROPERTY_ID để lưu trữ mã thuộc tính 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 GA4_PROPERTY_ID:

export GA4_PROPERTY_ID=[YOUR-GA4-PROPERTY-ID]

Thay thế [YOUR-GA4-PROPERTY-ID] bằng mã nhận dạng tài sản Google Analytics 4. Ví dụ:

export GA4_PROPERTY_ID=1234567890

Tạo yêu cầu JSON

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 với văn bản sau và lưu dưới dạng tệp văn bản thuần tuý request.json trong thư mục đang hoạt động 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 xác thực đượ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 một 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 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/$GA4_PROPERTY_ID:runReport -d @request.json

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

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

Xin chúc mừng! Bạn đã gửi yêu cầu đầu tiên của mình đến Google Analytics Data API.