Method: properties.runAccessReport

{
  "dimensions": [
    {
      object (AccessDimension)
    }
  ],
  "metrics": [
    {
      object (AccessMetric)
    }
  ],
  "dateRanges": [
    {
      object (AccessDateRange)
    }
  ],
  "dimensionFilter": {
    object (AccessFilterExpression)
  },
  "metricFilter": {
    object (AccessFilterExpression)
  },
  "offset": string,
  "limit": string,
  "timeZone": string,
  "orderBys": [
    {
      object (AccessOrderBy)
    }
  ],
  "returnEntityQuota": boolean,
  "includeAllUsers": boolean,
  "expandGroups": boolean
}

object (AccessDimension)

Các phương diện được yêu cầu và hiển thị trong phản hồi. Bạn có thể sử dụng tối đa 9 phương diện để yêu cầu.

object (AccessMetric)

Các chỉ số được yêu cầu và hiển thị trong phản hồi. Mỗi yêu cầu được phép có tối đa 10 chỉ số.

object (AccessDateRange)

Phạm vi ngày của bản ghi truy cập 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ì các bản ghi truy cập cho những ngày 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. Mỗi yêu cầu được phép có tối đa 2 phạm vi ngày.

object (AccessFilterExpression)

Bộ lọc phương diện cho phép bạn giới hạn phản hồi báo cáo ở một số giá trị phương diện cụ thể khớp với bộ lọc. Ví dụ: lọc các bản ghi quyền truy cập của một người dùng. Để tìm hiểu thêm, hãy xem bài viết Nguyên tắc cơ bản về bộ lọc phương diện để xem ví dụ. Không thể sử dụng chỉ số trong bộ lọc này.

object (AccessFilterExpression)

Bộ lọc chỉ số cho phép bạn giới hạn phản hồi báo cáo ở những giá trị chỉ số cụ thể khớp với bộ lọc. Bộ lọc chỉ số được áp dụng sau khi tổng hợp các hàng của báo cáo, tương tự như mệnh đề SQL. Bạn không thể sử dụng phương diện trong bộ lọc này.

string (int64 format)

Số hàng của hàng bắt đầu. Hàng đầu tiên được tính là hàng 0. Nếu không chỉ định độ dời, hệ thống sẽ coi độ dời là 0. Nếu độ dời bằng 0, thì phương thức này sẽ trả về trang kết quả đầu tiên có các mục limit.

Để tìm hiểu thêm về thông số phân trang này, hãy xem phần Phân trang.

string (int64 format)

Số lượng hàng sẽ trả về. Nếu không 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. limit phải là số dương.

API có thể trả về ít hàng hơn limit được yêu cầu nếu số hàng còn lại không bằng limit. Ví dụ: có ít hơn 300 giá trị có thể có cho phương diện country. Vì vậy, khi chỉ báo cáo về country, bạn không thể nhận được nhiều hơn 300 hàng, ngay cả khi bạn đặt limit thành một giá trị cao hơn.

Để tìm hiểu thêm về thông số phân trang này, hãy xem phần Phân trang.

string

Múi giờ của yêu cầu này nếu được chỉ định. Nếu bạn không chỉ định, hệ thống sẽ sử dụng múi giờ của tài sản. Múi giờ của yêu cầu được dùng để diễn giải ngày bắt đầu và ngày kết thúc của báo cáo.

Được định dạng dưới dạng chuỗi từ cơ sở dữ liệu Múi giờ IANA (https://www.iana.org/time-zones); ví dụ: "America/New_ Được" hoặc "Châu Á/Tokyo".

object (AccessOrderBy)

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

boolean

Bật/tắt tuỳ chọn trả về trạng thái hiện tại của hạn mức của Tài sản Analytics này. Hạn mức được trả về trong AccessQuota. Đối với các yêu cầu ở cấp tài khoản, trường này phải có giá trị là false.

boolean

Không bắt buộc. Xác định xem có nên đưa những người dùng chưa từng thực hiện lệnh gọi API vào phản hồi hay không. Nếu đúng, tất cả người dùng có quyền truy cập vào tài sản hoặc tài khoản được chỉ định đều được đưa vào phản hồi, bất kể họ đã thực hiện lệnh gọi API hay chưa. Nếu giá trị là false thì chỉ bao gồm những người dùng đã thực hiện lệnh gọi API.

boolean

Không bắt buộc. Quyết định xem có trả về người dùng trong các nhóm người dùng hay không. Trường này chỉ hoạt động khi bạn đặt includeAllUsers thành true. Nếu giá trị là true, thì hàm này sẽ trả về tất cả người dùng có quyền truy cập vào tài sản hoặc tài khoản được chỉ định. Nếu giá trị là false, thì hệ thống chỉ trả về những người dùng có quyền truy cập trực tiếp.