Method: users.watch

Theo dõi các 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

Thông số
domain

string

Tên miền. Điền vào trường này để chỉ lấy người dùng từ miền này. Thay vào đó, hãy trả về tất cả người dùng trong trường khách hàng điền sẵn nhiều miền".
customer

string

Mã nhận dạng không thay đổi của tài khoản Google Workspace. Trong trường hợp có 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)

Các 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 đặt giá trị này khi projection=custom.
maxResults

integer

Số lượng 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)

Nhóm nhỏ 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. Chứa một hoặc nhiều mệnh đề tìm kiếm, mỗi mệnh đề có một trường, toán tử và giá trị. Để xem tài liệu đầy đủ, hãy chuyển đến phần Tìm kiếm người dùng.
showDeleted

string

Nếu bạn đặt thành true, thì sẽ truy xuất danh sách người dùng đã bị xoá. (Mặc định: false)
sortOrder

enum (SortOrder)

Có trả về kết quả theo thứ tự tăng dần hay giảm dần hay không.
viewType

enum (ViewType)

Có tìm nạp chế độ xem công khai chỉ dành cho quản trị viên hoặc trên toàn miề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 dùng 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 thực thể của SubscriptionChannel.

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/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 Hướng dẫn uỷ quyền.

EventType

Loại sự kiện Đăng ký

Enum
ADD Sự kiện do người dùng tạo
DELETE Sự kiện người dùng đã bị xoá
MAKE_ADMIN Sự kiện thay đổi trạng thái quản trị viên người dùng
UNDELETE Sự kiện huỷ xoá người dùng
UPDATE Sự kiện người dùng được 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ự đoán

Enum
BASIC Không thêm bất kỳ trường tuỳ chỉnh nào 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 được 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ả các trường chỉ dành cho quản trị viên và các trường công khai trong miền.
domain_public Kết quả chỉ bao gồm các trường của người dùng mà người dùng khác trong miền có thể xem công khai.