Method: users.watch

Chú ý đến những thay đổi trong danh sách người dùng.

Yêu cầu HTTP

POST https://admin.googleapis.com/admin/directory/v1/users/watch

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

Tham số truy vấn

Tham số
domain	string Tên miền. Điền vào trường này để chỉ thêm người dùng từ miền này. Để trả về tất cả người dùng trong một trường nhiều miền, hãy điền thông tin khách hàng vào trường".
customer	string Mã nhận dạng bất biến của tài khoản Google Workspace. Trong trường hợp nhiều miền, để tìm nạp tất cả người dùng cho một khách hàng, hãy điền vào trường này thay vì miền.
event	enum (EventType) Sự kiện cần theo dõi.
customFieldMask	string Danh sách tên giản đồ được phân tách bằng dấu phẩy. Tất cả các trường trong những giản đồ này đều được tìm nạp. Bạn chỉ nên thiết lập thuộc tính này khi chiếu=custom.
maxResults	integer Số kết quả tối đa cần trả về.
orderBy	enum (OrderBy) Cột dùng để sắp xếp kết quả
pageToken	string Mã thông báo để chỉ định trang tiếp theo trong danh sách
projection	enum (Projection) Tập hợp con các trường cần tìm nạp cho người dùng này.
query	string Tìm kiếm chuỗi truy vấn. Phải có dạng "". Tài liệu đầy đủ có tại https: //developers.google.com/admin-sdk/directory/v1/guides/search-users
showDeleted	string Nếu bạn đặt chính sách này thành true, thì hệ thống sẽ truy xuất danh sách người dùng đã xoá. (Mặc định: false)
sortOrder	enum (SortOrder) Liệu sẽ trả về kết quả theo thứ tự tăng dần hay giảm dần.
viewType	enum (ViewType) Liệu có tìm nạp chế độ xem công khai trên toàn miền hay chỉ dành cho quản trị viên của người dùng hay không. Để biết thêm thông tin, hãy xem phần Truy xuất người dùng với tư cách là người không phải quản trị viên.

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

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của SubscriptionChannel.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau đây:

• https://www.googleapis.com/auth/admin.directory.user
• https://www.googleapis.com/auth/admin.directory.user.readonly
• https://www.googleapis.com/auth/cloud-platform

Để biết thêm thông tin, hãy xem bài viết Hướng dẫn uỷ quyền.

EventType

Loại sự kiện Gói thuê bao

Enum
ADD	Sự kiện do người dùng tạo
DELETE	Sự kiện do người dùng xoá
MAKE_ADMIN	Sự kiện thay đổi trạng thái quản trị viên của người dùng
UNDELETE	Sự kiện đã hủy xóa của người dùng
UPDATE	Sự kiện do người dùng cập nhật

OrderBy

Enum
EMAIL	Email chính của người dùng.
FAMILY_NAME	Họ của người dùng.
GIVEN_NAME	Tên của người dùng.

Dự kiến

Enum
BASIC	Đừng thêm trường tuỳ chỉnh cho người dùng.
CUSTOM	Bao gồm các trường tuỳ chỉnh trong các giản đồ được đề cập trong customFieldMask.
FULL	Bao gồm tất cả các trường liên kết với người dùng này.

SortOrder

Enum
ASCENDING	Thứ tự tăng dần.
DESCENDING	Thứ tự giảm dần.

ViewType

Enum
admin_view	Kết quả bao gồm cả trường chỉ dành cho quản trị viên và trường công khai trong miền.
domain_public	Kết quả chỉ bao gồm các trường dành cho người dùng mà những người dùng khác trong miền đó nhìn thấy công khai.