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ỉ nhận người dùng từ miền này. Để trả về tất cả người dùng trong trường khách hàng điền nhiều miền."
customer

string

Mã nhận dạng không thể thay đổi 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)

Các sự kiện cần chú ý.
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 các 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 bằng chuỗi truy vấn. Phải có dạng "". Bạn có thể xem tài liệu đầy đủ tại https: //developers.google.com/workspace/admin/directory/v1/guides/search-users
showDeleted

string

Nếu bạn đặt thành đúng, 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 có trả về kết quả theo thứ tự tăng dần hay giảm dần hay không.
viewType

enum (ViewType)

Liệu có tìm nạp chế độ xem công khai trên toàn miền dành cho quản trị viên hoặc chế độ xem công khai trên toàn miền dành cho người dùng hay không. Để biết thêm thông tin, hãy xem bài viết Truy xuất người dùng khi không phải là 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:

  • 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 Subscription

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 huỷ xoá người dùng
UPDATE Sự kiện 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ự đoán

Enum
BASIC Không thêm trường tuỳ chỉnh nào cho người dùng.
CUSTOM Bao gồm các trường tuỳ chỉnh từ 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ả 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 cho người dùng mà người dùng khác trong miền có thể xem công khai.