Method: properties.runPivotReport

Trả về báo cáo tổng hợp tuỳ chỉnh về dữ liệu sự kiện Google Analytics. Báo cáo tổng hợp là định dạng nâng cao và biểu cảm hơn so với báo cáo thông thường. Trong báo cáo tổng hợp, các phương diện chỉ xuất hiện nếu có trong bảng tổng hợp. Bạn có thể chỉ định nhiều bảng tổng hợp để phân tích dữ liệu chi tiết hơn.

Yêu cầu HTTP

POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runPivotReport

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
property

string

Giá trị nhận dạng tài sản Google Analytics có các sự kiện được theo dõi. Được chỉ định trong đường dẫn URL chứ không phải nội dung. Để tìm hiểu thêm, hãy xem bài viết nơi tìm mã tài sản. Trong một yêu cầu hàng loạt, bạn không nên chỉ định thuộc tính này hoặc phải chỉ định nhất quán với thuộc tính ở cấp lô.

Ví dụ: properties/1234

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "pivots": [
    {
      object (Pivot)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean,
  "comparisons": [
    {
      object (Comparison)
    }
  ]
}
Trường
dimensions[]

object (Dimension)

Các phương diện được yêu cầu. Tất cả các phương diện được xác định phải được dùng bởi một trong những phương diện sau: dimensionExpression, dimensionFilter, pivots, orderBys.
metrics[]

object (Metric)

Các chỉ số được yêu cầu, bạn cần chỉ định ít nhất một chỉ số. Tất cả các chỉ số được xác định phải được dùng bởi một trong những chỉ số sau: metric_expression, metricFilter, orderBys.
dateRanges[]

object (DateRange)

Phạm vi ngày để truy xuất dữ liệu sự kiện cho báo cáo. Nếu bạn chỉ định nhiều phạm vi ngày, thì dữ liệu sự kiện từ mỗi phạm vi ngày sẽ được dùng trong báo cáo. Bạn có thể thêm một phương diện đặc biệt có tên trường "dateRange" vào tên trường của сводная таблица; nếu được thêm, báo cáo sẽ so sánh giữa các phạm vi ngày. Trong yêu cầu về nhóm, bạn không được chỉ định dateRanges này.
pivots[]

object (Pivot)

Mô tả định dạng trực quan của các phương diện trong báo cáo theo cột hoặc hàng. Tập hợp của fieldNames (tên phương diện) trong tất cả các bảng tổng hợp phải là một tập hợp con của tên phương diện được xác định trong Phương diện. Không có hai bảng tổng hợp nào có thể dùng chung một phương diện. Một phương diện chỉ hiển thị nếu phương diện đó xuất hiện trong bảng tổng hợp.
dimensionFilter

object (FilterExpression)

Mệnh đề bộ lọc của phương diện. Bạn phải yêu cầu sử dụng các phương diện trong bộ lọc này. Bạn không thể sử dụng chỉ số trong bộ lọc này.
metricFilter

object (FilterExpression)

Mệnh đề bộ lọc của chỉ số. Được áp dụng ở giai đoạn tổng hợp sau, tương tự như mệnh đề having trong SQL. Bạn phải yêu cầu sử dụng các chỉ số trong bộ lọc này. Bạn không thể sử dụng phương diện trong bộ lọc này.
currencyCode

string

Mã đơn vị tiền tệ theo định dạng ISO4217, chẳng hạn như "AED", "USD", "JPY". Nếu trường này trống, báo cáo sẽ sử dụng đơn vị tiền tệ mặc định của tài sản.
cohortSpec

object (CohortSpec)

Nhóm когорта được liên kết với yêu cầu này. Nếu có một nhóm thuần tập trong yêu cầu, thì bạn phải có phương diện "nhóm thuần tập".
keepEmptyRows

boolean

Nếu là false hoặc không được chỉ định, thì mỗi hàng có tất cả chỉ số bằng 0 sẽ không được trả về. Nếu đúng, các hàng này sẽ được trả về nếu không bị bộ lọc xoá riêng.

Bất kể chế độ cài đặt keepEmptyRows này, chỉ dữ liệu do tài sản Google Analytics ghi lại mới có thể xuất hiện trong báo cáo.

Ví dụ: nếu một tài sản không bao giờ ghi lại sự kiện purchase, thì một truy vấn cho phương diện eventName và chỉ số eventCount sẽ không có hàng eventName: "purchase" và eventCount: 0.
returnPropertyQuota

boolean

Chuyển đổi để trả về trạng thái hiện tại của hạn mức tài sản Google Analytics này. Hạn mức được trả về trong PropertyQuota.
comparisons[]

object (Comparison)

Không bắt buộc. Cấu hình của các phép so sánh được yêu cầu và hiển thị. Yêu cầu này cần cả trường so sánh và phương diện so sánh để nhận được cột so sánh trong phản hồi.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể của RunPivotReportResponse.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics