- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- ApplicationName
- Hoạt động
- Hãy làm thử!
Truy xuất danh sách hoạt động cho tài khoản và ứng dụng của khách hàng cụ thể, chẳng hạn như ứng dụng Bảng điều khiển dành cho quản trị viên hoặc ứng dụng Google Drive. Để biết thêm thông tin, hãy xem hướng dẫn dành cho quản trị viên và báo cáo hoạt động trên Google Drive. Để biết thêm thông tin về các thông số của báo cáo hoạt động, hãy xem hướng dẫn tham khảo về thông số hoạt động.
Yêu cầu HTTP
GET https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Tham số | |
---|---|
userKey or all |
Đại diện cho mã hồ sơ hoặc email của người dùng cần lọc dữ liệu. Có thể là |
applicationName |
Tên ứng dụng cần truy xuất sự kiện. |
Tham số truy vấn
Tham số | |
---|---|
actorIpAddress |
Địa chỉ Giao thức Internet (IP) của máy chủ lưu trữ nơi sự kiện diễn ra. Đây là một cách khác để lọc bản tóm tắt của báo cáo bằng địa chỉ IP của người dùng có hoạt động được báo cáo. Địa chỉ IP này có thể phản ánh hoặc không phản ánh vị trí thực tế của người dùng. Ví dụ: địa chỉ IP có thể là địa chỉ của máy chủ proxy của người dùng hoặc địa chỉ mạng riêng ảo (VPN). Tham số này hỗ trợ cả phiên bản địa chỉ IPv4 và IPv6. |
customerId |
Mã nhận dạng duy nhất của khách hàng để truy xuất dữ liệu. |
endTime |
Đặt thời gian kết thúc của khoảng thời gian xuất hiện trong báo cáo. Ngày ở định dạng RFC 3339, ví dụ: 2010-10-28T10:26:35.000Z. Giá trị mặc định là thời gian gần đúng của yêu cầu API. Báo cáo API có ba khái niệm thời gian cơ bản:
endTime , báo cáo sẽ trả về tất cả các hoạt động từ startTime cho đến thời điểm hiện tại hoặc 180 ngày gần đây nhất nếu startTime nằm nhiều hơn 180 ngày trong quá khứ.
|
eventName |
Tên của sự kiện mà API truy vấn. Mỗi |
filters |
Chuỗi truy vấn Các thông số sự kiện này được liên kết với một Trong các ví dụ về hoạt động sau đây trên Drive, danh sách được trả về bao gồm tất cả sự kiện
Truy vấn
Lưu ý: API không chấp nhận nhiều giá trị của cùng một tham số. Nếu một tham số được cung cấp nhiều lần trong yêu cầu API, thì API chỉ chấp nhận giá trị mới nhất của tham số đó. Ngoài ra, nếu một tham số không hợp lệ được cung cấp trong yêu cầu API, thì API sẽ bỏ qua tham số đó và trả về phản hồi tương ứng với các tham số hợp lệ còn lại. Nếu không có tham số nào được yêu cầu, thì tất cả tham số sẽ được trả về. |
maxResults |
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 |
orgUnitID |
Mã của đơn vị tổ chức cần báo cáo. Bản ghi hoạt động sẽ chỉ được hiển thị cho người dùng thuộc đơn vị tổ chức đã chỉ định. |
pageToken |
Mã thông báo để chỉ định trang tiếp theo. Một báo cáo có nhiều trang sẽ có một thuộc tính |
startTime |
Đặt thời điểm bắt đầu của khoảng thời gian xuất hiện trong báo cáo. Ngày ở định dạng RFC 3339, ví dụ: 2010-10-28T10:26:35.000Z. Báo cáo trả về tất cả các hoạt động từ |
groupIdFilter |
Mã nhóm được phân tách bằng dấu phẩy (được làm rối mã nguồn) mà hoạt động của người dùng được lọc, tức là phản hồi sẽ chỉ chứa các hoạt động cho những người dùng thuộc ít nhất một trong các mã nhóm được đề cập ở đây. Định dạng: "id:abc123,id:xyz456" |
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Mẫu JSON cho tập hợp các hoạt động.
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:
Biểu diễn dưới dạng JSON |
---|
{
"kind": string,
"etag": string,
"items": [
{
object ( |
Trường | |
---|---|
kind |
Loại tài nguyên API. Đối với báo cáo hoạt động, giá trị là |
etag |
Thẻ ETag của tài nguyên. |
items[] |
Mỗi hoạt động sẽ ghi lại trong phản hồi. |
nextPageToken |
Mã thông báo để truy xuất trang tiếp theo của báo cáo. Giá trị |
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/admin.reports.audit.readonly
Để biết thêm thông tin, hãy xem bài viết Hướng dẫn uỷ quyền.
ApplicationName
Enum | |
---|---|
access_transparency |
Báo cáo về hoạt động Minh bạch quyền truy cập của Google Workspace trả về thông tin về các loại sự kiện Minh bạch về quyền truy cập. |
admin |
Báo cáo hoạt động của ứng dụng Bảng điều khiển dành cho quản trị viên trả về thông tin tài khoản về các loại sự kiện hoạt động của quản trị viên khác nhau. |
calendar |
Báo cáo hoạt động của ứng dụng Lịch Google trả về thông tin về nhiều sự kiện hoạt động trên Lịch. |
chat |
Báo cáo Hoạt động trên Chat trả về thông tin về các sự kiện hoạt động trong Chat. |
drive |
Báo cáo hoạt động của ứng dụng Google Drive trả về thông tin về các sự kiện hoạt động trên Google Drive. Chỉ khách hàng Google Workspace Business và Enterprise mới có thể xem báo cáo hoạt động trên Drive. |
gcp |
Báo cáo hoạt động của ứng dụng Google Cloud Platform trả về thông tin về các sự kiện hoạt động GCP khác nhau. |
gplus |
Báo cáo hoạt động của ứng dụng Google+ trả về thông tin về các sự kiện hoạt động trên Google+ khác nhau. |
groups |
Báo cáo hoạt động của ứng dụng Google Groups trả về thông tin về nhiều sự kiện hoạt động trên Groups. |
groups_enterprise |
Báo cáo hoạt động của Nhóm Enterprise trả về thông tin về các sự kiện hoạt động của nhóm Enterprise khác nhau. |
jamboard |
Báo cáo hoạt động trên Jamboard trả về thông tin về các sự kiện hoạt động trên Jamboard. |
login |
Báo cáo hoạt động của ứng dụng Đăng nhập trả về thông tin tài khoản về các loại Sự kiện hoạt động đăng nhập khác nhau. |
meet |
Báo cáo Hoạt động kiểm tra của Meet trả về thông tin về nhiều loại sự kiện của hoạt động Kiểm tra Meet. |
mobile |
Báo cáo Hoạt động kiểm tra thiết bị trả về thông tin về nhiều loại sự kiện của hoạt động Kiểm tra thiết bị. |
rules |
Báo cáo Hoạt động theo quy tắc trả về thông tin về các loại Sự kiện hoạt động liên quan đến Quy tắc. |
saml |
Báo cáo hoạt động SAML trả về thông tin về các loại sự kiện hoạt động SAML khác nhau. |
token |
Báo cáo hoạt động của ứng dụng Mã thông báo trả về thông tin tài khoản về nhiều loại sự kiện hoạt động của mã thông báo. |
user_accounts |
Báo cáo hoạt động của ứng dụng Tài khoản người dùng trả về thông tin tài khoản liên quan đến các loại sự kiện hoạt động Tài khoản người dùng khác nhau. |
context_aware_access |
Báo cáo hoạt động truy cập theo bối cảnh trả về thông tin về các sự kiện bị từ chối quyền truy cập của người dùng do Các quy tắc về quyền truy cập theo bối cảnh. |
chrome |
Báo cáo hoạt động trên Chrome trả về thông tin về các sự kiện của trình duyệt Chrome và ChromeOS. |
data_studio |
Báo cáo hoạt động trên Data Studio trả về thông tin về nhiều loại sự kiện hoạt động trên Data Studio. |
keep |
Báo cáo hoạt động của ứng dụng Keep trả về thông tin về các sự kiện hoạt động khác nhau trên Google Keep. Báo cáo hoạt động trên Keep chỉ dành cho khách hàng Google Workspace Business và Enterprise. |
vault |
Báo cáo hoạt động trên Vault trả về thông tin về nhiều loại sự kiện hoạt động trên Vault. |
Hoạt động
Mẫu JSON cho tài nguyên hoạt động.
Biểu diễn dưới dạng JSON |
---|
{ "kind": string, "etag": string, "ownerDomain": string, "ipAddress": string, "events": [ { "type": string, "name": string, "parameters": [ { "messageValue": { "parameter": [ { object ( |
Trường | |
---|---|
kind |
Loại tài nguyên API. Đối với báo cáo hoạt động, giá trị là |
etag |
ETag của mục nhập. |
ownerDomain |
Đây là miền chịu ảnh hưởng của sự kiện của báo cáo. Ví dụ: miền của Bảng điều khiển dành cho quản trị viên hoặc chủ sở hữu tài liệu của ứng dụng Drive. |
ipAddress |
Địa chỉ IP của người dùng thực hiện hành động. Đây là địa chỉ Giao thức Internet (IP) của người dùng khi đăng nhập vào Google Workspace. Địa chỉ này có thể phản ánh hoặc không phản ánh vị trí thực của người dùng. Ví dụ: địa chỉ IP có thể là địa chỉ của máy chủ proxy của người dùng hoặc địa chỉ mạng riêng ảo (VPN). API này hỗ trợ IPv4 và IPv6. |
events[] |
Các sự kiện hoạt động trong báo cáo. |
events[].type |
Loại sự kiện. Dịch vụ hoặc tính năng của Google Workspace mà quản trị viên thay đổi sẽ được xác định trong thuộc tính |
events[].name |
Tên của sự kiện. Đây là tên cụ thể của hoạt động được API báo cáo. Ngoài ra, mỗi
Để biết thêm thông tin về các thuộc tính eventName , hãy xem danh sách tên sự kiện cho nhiều ứng dụng ở trên trong applicationName .
|
events[].parameters[] |
Cặp giá trị tham số cho các ứng dụng khác nhau. Để biết thêm thông tin về các thông số |
events[].parameters[].messageValue |
Cặp giá trị thông số lồng nhau được liên kết với thông số này. Loại giá trị phức tạp cho một tham số được trả về dưới dạng danh sách giá trị tham số. Ví dụ: tham số địa chỉ có thể có giá trị là |
events[].parameters[].messageValue.parameter[] |
Giá trị thông số |
events[].parameters[].name |
Tên của thông số. |
events[].parameters[].value |
Giá trị chuỗi của tham số. |
events[].parameters[].multiValue[] |
Giá trị chuỗi của tham số. |
events[].parameters[].intValue |
Giá trị số nguyên của tham số. |
events[].parameters[].multiIntValue[] |
Giá trị số nguyên của thông số. |
events[].parameters[].boolValue |
Giá trị boolean của tham số. |
events[].parameters[].multiMessageValue[] |
Activity.list (Danh sách hoạt động) của đối tượng |
events[].parameters[].multiMessageValue[].parameter[] |
Giá trị thông số |
id |
Giá trị nhận dạng duy nhất của từng bản ghi hoạt động. |
id.time |
Thời gian xảy ra hoạt động. Đây là thời gian bắt đầu của hệ thống UNIX tính bằng giây. |
id.uniqueQualifier |
Bộ hạn định duy nhất nếu nhiều sự kiện diễn ra cùng một lúc. |
id.applicationName |
Tên ứng dụng chứa sự kiện. Để biết các giá trị có thể có, hãy xem danh sách ứng dụng ở trên trong |
id.customerId |
Mã nhận dạng duy nhất của tài khoản Google Workspace. |
actor |
Người dùng thực hiện hành động. |
actor.profileId |
Mã hồ sơ Google Workspace duy nhất của người thực hiện. Giá trị này có thể không xuất hiện nếu bên thực hiện không phải là người dùng Google Workspace hoặc có thể là số 105250506097979753968 (đóng vai trò là mã phần giữ chỗ). |
actor.email |
Địa chỉ email chính của người thực hiện. Có thể không xuất hiện nếu không có địa chỉ email liên kết với diễn viên. |
actor.callerType |
Kiểu người thực hiện. |
actor.key |
Chỉ hiển thị khi |