Method: userUsageReport.get

string

Biểu thị mã hồ sơ hoặc email người dùng mà dữ liệu sẽ được lọc. Có thể là all đối với tất cả thông tin hoặc userKey đối với mã hồ sơ Google Workspace duy nhất của người dùng hoặc địa chỉ email chính của họ. Không được là người dùng đã bị xoá. Đối với người dùng đã bị xoá, hãy gọi users.list trong Directory API bằng showDeleted=true, sau đó sử dụng ID được trả về làm userKey.

string

Biểu thị ngày xảy ra hoạt động sử dụng, dựa trên múi giờ UTC-8:00 (Giờ chuẩn Thái Bình Dương). Dấu thời gian ở định dạng ISO 8601, yyyy-mm-dd.

string

Mã nhận dạng duy nhất của khách hàng để truy xuất dữ liệu.

string

Chuỗi truy vấn filters là danh sách được phân tách bằng dấu phẩy gồm các thông số sự kiện của ứng dụng, trong đó giá trị của thông số được thao tác bằng toán tử quy chiếu. Chuỗi truy vấn filters bao gồm tên của ứng dụng có mức sử dụng được trả về trong báo cáo. Các giá trị ứng dụng cho Báo cáo mức sử dụng của người dùng bao gồm accounts, docs và gmail.

Các bộ lọc có dạng [application name]:[parameter name][relational operator][parameter value],....

Trong ví dụ này, toán tử "không bằng" <> được mã hoá URL trong chuỗi truy vấn của yêu cầu (%3C%3E):

GET
https://www.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03
?parameters=accounts:last_login_time
&filters=accounts:last_login_time%3C%3E2010-10-28T10:26:35.000Z 

Các toán tử quy chiếu bao gồm:

• == – "bằng".
• <> – "không bằng". Đó là URL được mã hoá (%3C%3E).
• < – "nhỏ hơn". Mã này được mã hoá URL (%3C).
• <= – "nhỏ hơn hoặc bằng". Mã này được mã hoá URL (%3C=).
• > – "lớn hơn". Dấu này được mã hoá URL (%3E).
• >= – "lớn hơn hoặc bằng". Mã này được mã hoá URL (%3E=).

integer (uint32 format)

Xác định số lượng bản ghi hoạt động được hiển thị trên mỗi trang phản hồi. Ví dụ: nếu yêu cầu đặt maxResults=1 và báo cáo có hai hoạt động, thì báo cáo sẽ có hai trang. Thuộc tính nextPageToken của phản hồi có mã thông báo đến trang thứ hai.
Chuỗi truy vấn maxResults là không bắt buộc.

string

Mã nhận dạng của đơn vị tổ chức mà bạn muốn báo cáo. Hoạt động của người dùng sẽ chỉ hiển thị cho những người dùng thuộc đơn vị tổ chức được chỉ định.

string

Mã thông báo để chỉ định trang tiếp theo. Báo cáo có nhiều trang sẽ có thuộc tính nextPageToken trong phản hồi. Trong yêu cầu tiếp theo để nhận trang tiếp theo của báo cáo, hãy nhập giá trị nextPageToken vào chuỗi truy vấn pageToken.

string

Chuỗi truy vấn parameters là danh sách các tham số sự kiện được phân tách bằng dấu phẩy để tinh chỉnh kết quả của báo cáo. Thông số này được liên kết với một ứng dụng cụ thể. Các giá trị ứng dụng cho báo cáo Mức sử dụng của khách hàng bao gồm accounts, app_maker, apps_scripts, calendar, classroom, cros, docs, gmail, gplus, device_management, meet và sites.
Chuỗi truy vấn parameters ở dạng CSV của app_name1:param_name1, app_name2:param_name2.

string

Mã nhận dạng nhóm được phân tách bằng dấu phẩy (đã làm rối mã) mà hoạt động của người dùng được lọc theo đó, tức là phản hồi sẽ chỉ chứa hoạt động của những người dùng thuộc ít nhất một trong các mã nhận dạng nhóm được đề cập ở đây. Định dạng: "id:abc123,id:xyz456"