Method: batchRunReports

Trả về nhiều báo cáo trong một loạt báo cáo. Tất cả báo cáo phải cho cùng một Pháp nhân.

Yêu cầu HTTP

POST https://analyticsdata.googleapis.com/v1alpha:batchRunReports

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

Nội dung yêu cầu

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

Biểu diễn dưới dạng JSON
{
  "entity": {
    object (Entity)
  },
  "requests": [
    {
      object (RunReportRequest)
    }
  ]
}
Trường
entity

object (Entity)

Tài sản có các sự kiện được theo dõi. Bạn phải chỉ định thực thể này cho lô. Thực thể trong RunReportRequest có thể chưa được chỉ định hoặc nhất quán với thực thể này.

requests[]

object (RunReportRequest)

Yêu cầu riêng lẻ. Mỗi yêu cầu có một phản hồi báo cáo riêng. Mỗi yêu cầu hàng loạt được phép có tối đa 5 yêu cầu.

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Phản hồi hàng loạt chứa nhiều báo cáo.

Biểu diễn dưới dạng JSON
{
  "reports": [
    {
      object (RunReportResponse)
    }
  ]
}
Trường
reports[]

object (RunReportResponse)

Câu trả lời riêng lẻ. Mỗi phản hồi có một yêu cầu báo cáo riêng.

Phạm vi cấp phép

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

RunReportRequest

Yêu cầu tạo báo cáo.

Biểu diễn dưới dạng JSON
{
  "entity": {
    object (Entity)
  },
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "offset": string,
  "limit": string,
  "metricAggregations": [
    enum (MetricAggregation)
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "orderBys": [
    {
      object (OrderBy)
    }
  ],
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean
}
Trường
entity

object (Entity)

Tài sản có các sự kiện được theo dõi. Trong yêu cầu hàng loạt, thực thể này phải không được chỉ định hoặc nhất quán với thực thể cấp lô.

dimensions[]

object (Dimension)

Các phương diện được yêu cầu và hiển thị.

metrics[]

object (Metric)

Các chỉ số được yêu cầu và được hiển thị.

dateRanges[]

object (DateRange)

Phạm vi ngày của dữ liệu cần đọc. Nếu bạn yêu cầu nhiều phạm vi ngày, thì mỗi hàng phản hồi sẽ chứa một chỉ mục phạm vi ngày dựa trên 0. Nếu hai phạm vi ngày trùng lặp, thì dữ liệu sự kiện cho những ngày bị trùng lặp sẽ được đưa vào các hàng phản hồi cho cả hai phạm vi ngày. Trong yêu cầu nhóm thuần tập, bạn không được chỉ định dateRanges này.

offset

string (int64 format)

Số lượng hàng của hàng bắt đầu. Hàng đầu tiên được tính là hàng 0.

limit

string (int64 format)

Số hàng cần trả về. Nếu tham số limit không được chỉ định, hệ thống sẽ trả về 10.000 hàng. API sẽ trả về tối đa 100.000 hàng cho mỗi yêu cầu, bất kể bạn yêu cầu bao nhiêu hàng.

metricAggregations[]

enum (MetricAggregation)

Tổng hợp các chỉ số. Các giá trị chỉ số được tổng hợp sẽ hiển thị trong những hàng mà giá trị tham số được đặt thành "RESERVED_(MetricTổ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 các phương diện để sử dụng trong bộ lọc này. 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 sau khi tổng hợp, tương tự như mệnh đề SQL. Bạn phải yêu cầu các chỉ số để sử dụng trong bộ lọc này. Không thể sử dụng các phương diện trong bộ lọc này.

orderBys[]

object (OrderBy)

Chỉ định cách sắp xếp các hàng trong phản hồi.

currencyCode

string

Mã đơn vị tiền tệ ở đị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 thực thể.

cohortSpec

object (CohortSpec)

Nhóm thuần tập đượ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ì "nhóm thuần tập" bắt buộc phải có phương diện.

keepEmptyRows

boolean

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

returnPropertyQuota

boolean

Bật/tắt tính năng trả về trạng thái hiện tại của hạn mức cho Tài sản Analytics này. Hạn mức được trả về trong PropertyQuota.