Trang này được dịch bởi Cloud Translation API.

Method: activities.watch

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
- Biểu diễn dưới dạng JSON
Phạm vi uỷ quyền
ApplicationName

Bắt đầu nhận thông báo về hoạt động của tài khoản. Để biết thêm thông tin, hãy xem phần Nhận thông báo đẩy.

Yêu cầu HTTP

POST https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}/watch

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

Tham số đường dẫn

Tham số

Tham số
`userKey or all`	`string` Đạ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à `all` đối với mọi thông tin hoặc `userKey` đối với mã hồ sơ Google Workspace duy nhất của người dùng hay địa chỉ email chính của người dùng. 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`.
`applicationName`	`enum (ApplicationName)` Tên ứng dụng cần truy xuất sự kiện.

userKey or all

string

Đạ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à all đối với mọi thông tin hoặc userKey đối với mã hồ sơ Google Workspace duy nhất của người dùng hay địa chỉ email chính của người dùng. 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.

applicationName

enum (ApplicationName)

Tên ứng dụng cần truy xuất sự kiện.

Tham số truy vấn

Tham số
`actorIpAddress`	`string` Đị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`	`string` Mã nhận dạng duy nhất của khách hàng để truy xuất dữ liệu.
`endTime`	`string` Đặ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: Ngày API yêu cầu báo cáo: Thời điểm API tạo và truy xuất báo cáo. Thời gian bắt đầu của báo cáo: Thời điểm bắt đầu khoảng thời gian hiển thị trong báo cáo. `startTime` phải trước `endTime` (nếu được chỉ định) và thời gian hiện tại khi yêu cầu được thực hiện hoặc API trả về lỗi. Thời gian kết thúc của báo cáo: Thời gian kết thúc của khoảng thời gian hiển thị trong báo cáo. Ví dụ: khoảng thời gian của các sự kiện được tóm tắt trong một báo cáo có thể bắt đầu vào tháng 4 và kết thúc vào tháng 5. Bạn có thể yêu cầu báo cáo này vào tháng 8. Nếu bạn không chỉ định `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`	`string` Tên của sự kiện mà API truy vấn. Mỗi `eventName` liên quan đến một dịch vụ hoặc tính năng cụ thể của Google Workspace mà API sắp xếp thành các loại sự kiện. Ví dụ: các sự kiện trên Lịch Google trong báo cáo của ứng dụng Bảng điều khiển dành cho quản trị viên. Cấu trúc Cài đặt lịch `type` có tất cả các hoạt động Lịch `eventName` được API báo cáo. Khi quản trị viên thay đổi một chế độ cài đặt Lịch, API sẽ báo cáo hoạt động này trong các thông số `type` và `eventName` của chế độ cài đặt Lịch. Để biết thêm thông tin về chuỗi truy vấn và tham số `eventName`, hãy xem danh sách tên sự kiện cho các ứng dụng ở trên trong `applicationName`.
`filters`	`string` Chuỗi truy vấn `filters` là một danh sách được phân tách bằng dấu phẩy bao gồm các thông số sự kiện do các toán tử quy chiếu thao tác. Thông số sự kiện có dạng `{parameter1 name}{relational operator}{parameter1 value},{parameter2 name}{relational operator}{parameter2 value},...` Các thông số sự kiện này được liên kết với một `eventName` cụ thể. Hệ thống sẽ trả về một báo cáo trống nếu tham số của yêu cầu không thuộc `eventName`. Để biết thêm thông tin về các trường `eventName` có sẵn cho từng ứng dụng và thông số liên quan, hãy chuyển đến bảng ApplicationName, sau đó nhấp vào trang Sự kiện hoạt động trong Phụ lục cho ứng dụng mà bạn muốn. 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 `edit`, trong đó giá trị tham số `doc_id` khớp với các điều kiện do toán tử quy chiếu xác định. Trong ví dụ đầu tiên, yêu cầu trả về tất cả tài liệu đã chỉnh sửa có giá trị `doc_id` bằng `12345`. Trong ví dụ thứ hai, báo cáo trả về mọi tài liệu đã chỉnh sửa có giá trị `doc_id` không bằng `98765`. Toán tử `<>` được mã hoá URL trong chuỗi truy vấn của yêu cầu (`%3C%3E`): `GET...&eventName=edit&filters=doc_id==12345 GET...&eventName=edit&filters=doc_id%3C%3E98765` Truy vấn `filters` hỗ trợ các toán tử quy chiếu sau: `==`—"bằng". `<>`—'không bằng'. Phải được mã hoá URL (%3C%3E). `<`—'nhỏ hơn'. Phải được mã hoá URL (%3C). `<=`—'nhỏ hơn hoặc bằng'. Phải được mã hoá URL (%3C=). `>`—'lớn hơn'. Phải được mã hoá URL (%3E). `>=`—'lớn hơn hoặc bằng'. Phải được mã hoá URL (%3E=). 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`	`integer` 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 trong yêu cầu. Giá trị mặc định là 1000.
`orgUnitID (deprecated)`	`string` `Deprecated`. Trường này không được dùng nữa và không còn được hỗ trợ. 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. Dữ liệu trước ngày 17 tháng 12 năm 2018 không xuất hiện trong kết quả đã lọc.
`pageToken`	`string` 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 `nextPageToken` trong phản hồi. Trong yêu cầu tiếp theo về việc 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`.
`startTime`	`string` Đặ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ừ `startTime` đến `endTime`. `startTime` phải trước `endTime` (nếu được chỉ định) và thời gian hiện tại khi yêu cầu được thực hiện hoặc API trả về lỗi.
`groupIdFilter`	`string` 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 chứa một bản sao của SubscriptionChannel.

Nội dung phản hồi

Kênh thông báo dùng để theo dõi các thay đổi về tài nguyên.

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
{ "id": string, "token": string, "expiration": string, "type": string, "address": string, "payload": boolean, "params": { string: string, ... }, "resourceId": string, "resourceUri": string, "kind": string }

Biểu diễn dưới dạng JSON

{
  "id": string,
  "token": string,
  "expiration": string,
  "type": string,
  "address": string,
  "payload": boolean,
  "params": {
    string: string,
    ...
  },
  "resourceId": string,
  "resourceUri": string,
  "kind": string
}

Trường
`id`	`string` Mã nhận dạng duy nhất (UUID) hoặc chuỗi duy nhất tương tự giúp nhận dạng kênh này.
`token`	`string` Một chuỗi tuỳ ý được gửi tới địa chỉ đích với mỗi thông báo được gửi qua kênh này. Không bắt buộc.
`expiration`	`string (int64 format)` Ngày và giờ hết hạn kênh thông báo, được biểu thị bằng dấu thời gian Unix, tính bằng mili giây. Không bắt buộc.
`type`	`string` Loại cơ chế phân phối được sử dụng cho kênh này. Bạn phải đặt giá trị là `"web_hook"`.
`address`	`string` Địa chỉ gửi thông báo cho kênh này.
`payload`	`boolean` Giá trị Boolean cho biết liệu tải trọng có cần thiết hay không. Tải trọng dữ liệu là dữ liệu được gửi trong phần nội dung của thông báo HTTP POST, PUT hoặc PATCH và chứa thông tin quan trọng về yêu cầu. Không bắt buộc.
`params`	`map (key: string, value: string)` Các tham số bổ sung kiểm soát hành vi của kênh phân phối. Không bắt buộc. Đối tượng chứa danh sách các cặp `"key": value`. Ví dụ: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`resourceId`	`string` Mã không rõ ràng xác định tài nguyên đang được xem trên kênh này. Ổn định trên nhiều phiên bản API.
`resourceUri`	`string` Giá trị nhận dạng theo phiên bản cụ thể của tài nguyên đã xem.
`kind`	`string` Nhận dạng đây là kênh thông báo dùng để theo dõi các thay đổi đối với tài nguyên, đó là "`api#channel`".

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

Tên ứng dụng cần truy xuất sự kiện.

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à Google Workspace 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.