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 nội dung phản hồi. Bạn được phép gửi yêu cầu có tối đa 10 chỉ số.

object (AccessDateRange)

Phạm vi ngày của các 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ì bản ghi truy cập của các 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. 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 hạn chế phản hồi của báo cáo ở các 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 hạn chế phản hồi của báo cáo ở các 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. Không thể sử dụng các phương diện trong bộ lọc này.

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. Nếu không chỉ định độ lệch, giá trị này được coi là 0. Nếu độ lệch 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 nhập limit.

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

string (int64 format)

Số hàng cần trả về. Nếu bạn không chỉ định thì 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 so với limit được yêu cầu nếu không có nhiều hàng còn lại như 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 nhiều hơn 300 hàng, ngay cả khi bạn đặt limit thành giá trị cao hơn.

Để tìm hiểu thêm về thông số phân trang này, hãy xem nội dung 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, múi giờ của cơ sở lưu trú sẽ được sử dụng. Múi giờ của yêu cầu được sử dụng để diễn giải thời điểm 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 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 AccessQuota. Đối với các yêu cầu ở cấp tài khoản, trường này phải 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ả lại 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 includeAllUsers được đặt thành true. Nếu đúng, 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 đã 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.