Method: accounts.runAccessReport

Trả về báo cáo tuỳ chỉnh gồm các bản ghi truy cập dữ liệu. Báo cáo này cung cấp bản ghi mỗi lần người dùng đọc dữ liệu báo cáo của Google Analytics. Hồ sơ truy cập sẽ được lưu giữ trong tối đa 2 năm.

Bạn có thể yêu cầu Báo cáo truy cập dữ liệu cho một tài sản. Bạn có thể yêu cầu báo cáo cho bất kỳ tài sản nào, nhưng bạn chỉ có thể yêu cầu những phương diện không liên quan đến hạn mức trên tài sản Google Analytics 360. Phương thức này chỉ dành cho Quản trị viên.

Những bản ghi quyền truy cập dữ liệu này bao gồm Báo cáo giao diện người dùng của GA, Khám phá giao diện người dùng của GA, API dữ liệu của GA, cũng như các sản phẩm khác như Firebase và AdMob có thể truy xuất dữ liệu từ Google Analytics thông qua một mối liên kết. Những bản ghi này không bao gồm các thay đổi về cấu hình tài sản như việc thêm luồng hoặc thay đổi múi giờ của một tài sản. Để biết nhật ký thay đổi cấu hình, hãy xem searchChangeHistoryEvents.

Để đưa ra ý kiến phản hồi về API này, hãy hoàn thành biểu mẫu phản hồi về Báo cáo quyền truy cập vào Google Analytics.

Yêu cầu HTTP

POST https://analyticsadmin.googleapis.com/v1beta/{entity=accounts/*}:runAccessReport

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

Tham số đường dẫn

Thông số
entity

string

Báo cáo quyền truy cập dữ liệu hỗ trợ việc yêu cầu ở cấp tài sản hoặc cấp tài khoản. Nếu được yêu cầu ở cấp tài khoản, Báo cáo truy cập dữ liệu sẽ bao gồm toàn bộ quyền truy cập cho tất cả các tài sản trong tài khoản đó.

Để yêu cầu ở cấp tài sản, thực thể phải là ví dụ như "properties/123" nếu "123" là mã tài sản GA4 của bạn. Để yêu cầu ở cấp tài khoản, pháp nhân phải là "accounts/1234" (ví dụ: "accounts/1234") nếu "1234" là mã tài khoản GA4 của bạn.

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
{
  "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
}
Trường
dimensions[]

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.

metrics[]

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ố.

dateRanges[]

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.

dimensionFilter

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.

metricFilter

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.

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. 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.

limit

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.

timeZone

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".

orderBys[]

object (AccessOrderBy)

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

returnEntityQuota

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.

includeAllUsers

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ỉ những người dùng đã thực hiện lệnh gọi API mới được đưa vào.

expandGroups

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.

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 phiên bản của RunAccessReportResponse.

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.edit